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(54) Video on demand applet method and apparatus for inclusion of motion video in multimedia 
documents 



(57) The present specification describes a computer 
process which requests streams of motion video titles 
and decodes and displays the motion video signals of 
the stream for display in a computer display device is 
constructed in the form of an applet 21 2 of a multimedia 
document viewer 202 such as a World Wide Web brows- 
er. Accordingly a designer of multimedia documents 
such as HTML pages can easily incorporate motion vid- 
eo titles into such HTML pages by specifying a few pa- 
rameters of a desired title or a desired portion of a title 
to be requested from a video server 250. The applet 212 
builds bit stream control signals from the specification 
of the title or the portion of the title The bit stream control 
signals request transmission of the title or the portion of 
the title from a bit stream server such as a video server 



250 and are in a form appropriate for processing by the 
bit stream server. The applet 212 transmits the bit 
stream control signals to the bit stream server 250 to 
thereby request that the bit stream server 250 initiate 
transmission of a bit stream representing the requested 
title or the requested portion of the title. The applet 212 
also builds decoder control signals from the specifica- 
tion of the title or the portion of the title The decoder 
control signals direct a bit stream decoder 204 to receive 
the requested bit stream from the bit stream server 250 
and to decode a motion video signal from the bit stream 
The applet 212 transmits the decoder control signals to 
the decoder 204 to cause the decoder 204 to receive 
the bit stream and to decode the motion video signal 
from the bit stream. 



ut,i_rjM£isiA : '• mistime jl* ceccdf-? t _;5e! 

i ZQti V!lw£? " ■ 

I I*—, r- PROCESSOR 
■ ! 212t re* j !C2 

CM | ■ ~ J - , " < - ^ 

< ! 106 
t - , • _- i . 

CO J_ — - * 

CM 

00 _. I . 

55 - '» L ■•■ ' — 

co -~ i-.V— • - 

o 

LLI 



FIG. I 



Printed Jouve .~£0G' PAR'S -PR' 



EP 0 803 826 A2 



I 



Description 

A portion of the disclosure of thts oatent document contains materia! which is subject to copyright protection The 
copyright owner has no objection to the facsimile reproduction by anyone of the pateni document or the patent disclo- 
5 sure, as it appears tn the Patent and T-ademark Office patent file or records, but otherv. se reserves all copyright rights 
whatsoever. 

FIELD OF THE INVENTION 

io The present invention relates to computer graphical display of motion video and in particular, to a method and 

apparatus for facilitating inclusion of motion video in multimedia computer displays 

BACKGROUND OF THE INVENTION 

fS Video servers, including networked video servers, transmit "bit streams" to a video client. Such bit streams, which 

are sometimes referred to as "streams." generally represent video and/or audio signals which represent titles in a 
library of multimedia sources. Exampies of titles of such a library typically include recordings of motion pictures. In 
general, a video server receives from a video client a request for a particular title and transmits a stream of the particular 
title to the video client. An example o? a video client is a set top box which is generally known and which decodes the 

20 stream received from the video server and transmits the decoded signal to a connected television. The requesting of 
a particular title, receiving the stream of the particular title, and decoding the stream for display on a television are 
collectively and generally referred to as video on demand 

Examples of such video on demand servers are described in U.S. Patent Application Serial Number 08/572 639 
filed December 14 1995 by Kallol Mandal and Steven Kletman and entitled "Method and Apparatus for Delivering 

25 Simultaneous Constant Bit Rate Compressed Video Streams at Arbitrary Bit Rates with Constrained Drift and Jitter" 
(hereinafter the '639 Application) and in U.S. Patent Application Serial Number 08/572 648. filed December 14. 1995 
by Kallol Mandal and Steven Kletman and entitled "Method and Apparatus for Distributing Network Bandwidth on a 
Video Server for Transmission of Bit Streams Across Multiple Network Interfaces Connected to a Single Internet Pro- 
tocol (IP) Network" [hereinafter the '645 Application). Both the '639 Application and the '548 Application are incorporated 

30 herein in their entirety by reference. 

The popularity of the Internet global network is growing extremely rapidly, and perhaps the most popular protocol 
of the Internet is the Hyper Text Transfer Protoco\ (HTTP) of the World Wide Web According to the HTTP protocol of 
the World Wide Web documents, whsch are generally referred to as "pages. " incorporate text, graphical images, sound, 
and motion video which, when viewed form a multimedia presentation to user Such pages are typically viewed using 

35 a World Wide Web browser, which is a computer process capable of retrieving HTTP pages and presenting the contents 
of such pages to a user of a computer system through output devices such as a comouter video display device and a 
computer audio circuit coupled to one or more audio speakers An example of a World Wide Web browser js the 
Netscape browser available from Netscape Communications Corporation of Mountain View. California 

To display motion video, conventional browsers typically fi) transfer to the computer system tn which the browser 

-*o executes an entire data file which includes data representing a title and (ii) subsequently initiate execution of a player 
computer process which displays the title to the user on a computer display device The player computer process ts 
separate from the browser and therefore displays the motion video of the title outssde of the page displayed by the 
browser In addition, transferring the entire data file prior to displaying the motion video of the title delays substantially 
the display of the motion video since such data files are typically quite large e g typically 1.3 gigabytes of data to 
represent a two-hour. VHS-quality motion picture 

Currently, no browser is capable of seamlessly integrating motion video streams into a page of the World Wide Web 

SUMMARY OF THE INVENTION 

so in accordance with the present invention a computer process which requests streams of motion video titles and 

decodes and displays the motion video signals of the stream for display in a computer display device is constructed 
in the form of an applet of a multimedia document viewer such as a World Wide Web browser. Accordingly, a designer 
of multimedia documents such as HTML pages can easily incorporate motion video titles into such HTML pages by 
specifying a few parameters of a desired title or a desired portion of a title to be requested from a video server The 

5S specification of the parameters is in the general form of a well-known parameter specification format dictated by the 
particular interface of the computer instruction language in which the applet is written. 

The applet builds bit stream control signals from the specification of the title or the portion of the title. The bit stream 
control signals request transmission of the title or the portion of the title from a bit stream server such as a video server 
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anc are in a form appropriate for processing by the cit stream server The applet transmits the bit stream control signals 
to tre bit stream server to thereby request that the bit stream server initiate transmission of a bit stream representing 
the requested title or the requested portion of the title. 

The applet also builds decoder control signals from the specification of the title or the portion of the title. The 
decoder control signals direct a bit stream decode*- to receive the requested bit stream from the bit stream server and 
to decode a motion video signal from the bit stream The applet transmits the decoder control signals to the decoder 
to cause the decoder to receive the bit stream anc to decode the motion video signal from the bit stream. 

3y using an applet of a multimedia document viewer to request and control receipt by a decoder of a motion video 
bit stream and to control decoding of the motion video bit stream by the decoder, a designer of a multimedia document 
can easily and conveniently include motion video images in multimedia documents. In addition, since the applet trans- 
mits bit stream control signals to a video server, the motion video signals which can be incorporated into a multimedia 
document are any such motion video signals stored in such a video server. Such video servers will likely include a 
large number and wide variety of motion video signals, thereby providing a wealth of motion video content for inclusion 
in multimedia documents. 

The present invention will now be further described, by way of example, with reference to the accompanying 
drawings, in which: - 

Figure 1 is a block diagram of a computer system which is connected to a video server through a network and 
wh»ch includes a multimedia document viewer which in turn processes an applet to include motion video images in a 
representation of a multimedia document in accordance with the presenting invention. 

Figure 2 is a block diagram showing the multimedia document viewer, applet, and video server of Figure 1 in 
greater detail. 

Figure 3 is a block diagram of an applet tag of Figure 2 in greater detail. 
Figure 4 is a block diagram of the applet of Figure 2 in greater detail. 

DETAILED DESCRIPTION 

In accordance with the present invention, a multimedia document 206 (Figure 2) includes an applet 214 which 
causes a multimedia document viewer 202 to execute an applet 212. Execution of applet 212 requests transmission 
of a bit stream of a particular title from a video server 250 and controls receipt and decoding of the bit stream by a 
decoder 204. Decoder 204. in response to control signals received from applet 212. decodes the received bit stream 
to produce a motion video image and displays the motion video image as an integral part of the representation 'ot^ 
multimedia document 206. To include a motion video image as an integral part of a multimedia document, a designer 
of the multimedia document simply includes in the multimedia document an applet tag, e.g., applet tag 214. which 
specifies f i) applet 212 (ii) video servoer 250 as the source of a bit stream, and (tii) the particular bit stream to request 
from video server 250. A brief description of the operating environment of multimedia document viewer 202 and applet 
212 facilitates appreciation ofthe present invention 

Figure 1 is a block diagram of a computer system 100 which is generally of the architecture of most computer 
systems available today. Computer system 100 includes a processor 102 which fetches computer instructions from a 
memory 104 through a bus 106 and executes these computer instructions, in executing computer instructions fetched 
from memory 104. processor 102 can retrieve data from or write data to memory 104. display information on one or 
more computer display devices 1 30. or receive command signals from one or more user-input devices 120. Processor 
102 can be. for example, any of the SPARC processors available from Sun Microsystems. Inc. of Mountain view. 
California. Memory 104 can include any type of computer memory including, without limitation, randomly accessible 
memory (RAM), read-only memory (ROM), and storage devices which include magnetic and optical storage media 
such as magnetic or optical disks. Computer 100 can be. for example, any of the SPARCstation workstation computer 
systems available from Sun Microsystems, inc of Mountain View. California 

Sun Sun Microsystems, the Sun Logo. Java and Hot Java are trademarks or registered trademarks of Sun Mi- 
crosystems. Inc. in the United States and other countries. All SPARC trademarks are used under license and are 
trademarks of SPARC International. Inc. in the United States and other countries. Products bearing SPARC trademarks 
are based upon an architecture developed by Sun Microsystems. Inc. 

Computer display devices 1 30 can include generally any computer display device such as a printer a cathode ray 
tube (CRT), light-emitting diode (LED) display or a liquid crystal display (LCD). User input devices 120 can include 
generally any user input device such as a keyboard, a keypad, an electronic mouse, a trackball, a digitizing tablet, 
thumbwheels, a light-sensitive pen. a touch-sensitive pad. or voice-recognition circuitry. 

Computer system 100 also includes network access circuitry 140 which is coupled to processor 102 and memory 
104 through bus 106 and which is coupled to a network 1 50. In accordance with control signals received from processor 
(02 through bus 106. network access circuitry 140 coordinates transfer of data through network 150 between network 
access circuitry 140 and similar network access circuitry (not shown) in computer 1008 or other computer systems 
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coupled to computer system 1 00 through network 1 50 The transfer of data through network 1 50 is conventional. Since 
a video stream representing a VHS-qualtty motion picture encoded in MPEG-1 format has a bit rate of approximately 
1.5 Mbit/second to 2 Mbit/second, a useful minimum threshold is that network access circuitry 140 is capable of re- 
ceiving data at a rate of at least 2 Mbit/second. Higher quality motion video images have bit rates as high as 8 Mbit/ 
second or higher. Therefore m one embodiment, network access circuitry 1 40 is capable of receiving data at a rate of 
at least 8 Mbit/second. Network access circuitry 140 can be generally any circuitry which is used to transfer data 
between a computer system and network such as computer system 100 and network 150 and can be. for example 
an Ethernet controller chip. 

A number of computer processes execute in processor 102 from memory 104. including a multimedia document 
viewer 202 and a decoder 204. Multimedia document viewer 202 is a computer process which reads a multimedia 
document 206 and displays the multimedia information specified in multimedia document 206 in one or more of com- 
puter display devices 1 30. In one embodiment multimedia document 206 is a document in HTML format and multimedia 
document viewer 202 is an HTML viewer such as the Netscape World Wide Web browser available from Netscape 
Communications Corporation of Mountain View. California. Multimedia document viewer 202 and multimedia document 
206 are shown in greater detail in Figure 2. 

Multimedia document viewer 202 retrieves data and tags from a multimedia document such as multimedia docu- 
ment 206. A tag is data which is not itself substantive content of a multimedia document but instead provides format 
information and can include specification of substantive content which is to be included in the multimedia document 
and which is located in memory 104 outside of multimedia document 206. For example, a tag can specify a ftle stored 
in memory 1 04 as containing a graphical image which is to be included as substantive content of multimedia document 
206. The data and tags of multimedia document 206 collectively define the composition, including substantive content 
and formatting, of multimedia document 206: and multimedia document viewer 202 displays such substantive content 
in one or more of computer display devices 1 30 (Figure 1 ) in accordance with the data and tags of multimedia document 
206. In one embodiment, multimedia document 206 is an HTML document, and the data and tags of multimedia doc- 
ument 206 comport with the HTML language. Multimedia document 206 includes an applet tag 214 (Figure 2) which 
specifies an applet 21 2 and a number of operational characteristics of applet 21 2 as described more completely below. 

Multimedia document viewer 202 includes an applet interpreter 210 which retrieves from applet 212 computer 
instructions and translates such computer instructions into computer instructions of a form appropriate for execution 
by processor 102 (Figure 1) and submits the translated computer instructions to processor 102 for execution. In one 
embodiment, applet interpreter 210 (Figure 2) translates and submits for execution a single computer instruction of 
applet 21 2 prior to translation and submission for execution of a subsequent computer instruction of applet 212. Applet 
interpreter 210 can be. for example, the Java applet interpreter or the Hot Java World Wide Web browser available 
from Sun Microsystems. Inc. and. in such an embodiment, applet 212 comports with the Java computer instruction 
language interpreted by the Java applet interpreter. As described more completely below, applet 212 is a novel applet 
which, when executed by processor 102 (Figure 1) through appiet interpreter 210 (Figure 2). requests a title from a 
video server 250 and causes the received bit stream representing the requested title to be decoded in a decoder 204 
and displayed in a computer display device as an integral part of a multimedia display of multimedia document 206 
In executing the computer instructions of applet 212. applet interpreter 21 0 transmits, through network 1 50 (Figure 

1 ) . control signals to an applications programming interface (API) 252 (Figure 2) of a video server 250 which executes 
within a computer system 160 (Figure 1). Illustrative examples of video server 250 of computer system 160 are de- 
scribed in the '639 and '648 Applications. API 252 (Figure 2) of video server 250 implements a remote procedure catling 
(RPC) protocol in which API 252 controls video server 250 in response to control signals received by API 252. For 
example, in response to control signals which request a title and which are transmitted to API 252 by applet interpreter 
210. API 252 causes a bit pump 254 of video server 250 to initiate transmission through network 150 (Figure 1) to 
decoder 204 (Figure 2) of a bit stream representing the requested title. In addition API 252 can transmit to applet 
interpreter 210 status information regarding a title stored within video server 250 or regarding a bit stream transmitted 
by bit pump 254 in response to control signals requesting such status information. 

Decoder 204 is a computer process executing within processor 102 (Figure ^) from memory 104. Decoder 204 
receives data representing a motion video display encoded in a canicular format. In one embodiment, decoder 204 is 
the MPEG Expert (MPX) decoder available from Applied Vision and decodes motion video signals according to the 
MPEG-1 encoding format. Applet interpreter 210 transmits to decoder 204 control signals which control the decoding 
by decoder 204 of the bit stream received from bit pump 254 of video server 250. Specifically applet interpreter 210 
transmits to decoder 204 control signals directing decoder 204 to start or stop decoding the bit stream received from 
bit pump 254 or specifying characteristics of the bit stream received from bit pump 254 such as the bit rate, encoding 
format, and the coordinates of a particular location within one or more of computer display devices 130 (Figure 1) in 
which to display the decoded motion video images. In addition applet 212 determines which communications port 
through network access circuitry 140 (Figure 1) the bit stream is to be received and transmits to decoder 204 (Figure 

2) control signals identifying the selected communications port Applet 212 can therefore determine which communi- 
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cations ports are used by other applications and can avoid conflicts resulting ^rom access of decoder 204 of a com- 
munications port by selecting a communications port which is not used by another computer process of computer 
system 100 (Figure 1). 

Applet tag 214 is shown in greater detail in Figure 3. Applet tag 214 includes a number of fields which collectively 

5 define a bit stream to be received and decoded for display by decoder 204 (Figure 2). A field is a collection of data 
which collectively define a item of information. Applet tag 214 includes (i) an applet identifier field 302. (ii) a width field 
304. (iii) a height field 306. (iv) a server identifier field 303. and (v) an encoding format field 310. Applet tag 214 can 
also include any of the following optional fields, (vi) a title field 312. (vii) an image field 314. (viii) a playpause field 
316. (ix) a start field 318. and (x) a duration field 320. 

10 Applet identifier field 302 specifies applet 212 as the applet to be retrieved and executed by applet interpreter 210. 

Width field 304 and height field 306 specify the width and height, respectively, in display coordinate space of a computer 
display device, i.e.. specify the size of the viewport in which the decoded motion video image is displayed. Server 
identifier field 308 specifies video server 250 (Figure 2) as the source of the desired bit stream. Encoding format field 
310 (Figure 3) specifies the particular encoding format, e.g., MPEG 1 SYS encoding format, ofthe bit stream received 

*s by decoder 204 (Figure 2). Title field 31 2 (Figure 3) specifies the particular title to be retrieved from server 250 (Figure 
2). Alternatively, title field 31 2 can specify the address of a multicast bit stream 

Image field 314 (Figure 3). if included, specifies a still video image to be displayed in the space specified by width 
field 304 and height field 306 if the title specified by title field 312 is unavailable. Play/pause field 316. if included, 
specifies whether the motion video image received from video server 250 (Figure 2) is initially in a ptay state or in a 

20 paused state Start field 318 (Figure 3). if included, specifies an offset into the title of a portion of the title, i.e., the point 
within the title at which the bit stream should begin. For example, start field 313 can specify that the requested bit 
stream begin at 3 minutes and 10 seconds into the title Duration field 320. if included specifies the duration of a desired 
portion of the title. For example, duration field 320 can specify that a 30-minute portion of the title is requested In one 
embodiment, start field 313 and duration field 320 are specified in terms of an integer number of nanoseconds. 

25 Thus, by specifying the few fields described above and shown in Figure 3 a designer of multimedia document 206 

can include as an integral part of multimedia document 206 a motion video image retrieved from video server 250. The 
following is an illustrative example of applet tag 214 in HTML format. 

<applet code="SunMediaCenterPlayer.class" width=704 height=520> 
30 <param name-port value="1973"> 

<param name-format value=*MPEG 1 SYS"> 
<param name-host value-"sqas-6 ,( > 
<param name=img valuer "''images/bkgx gif"> 
</applet> 

35 

Applet 212 (Figure 2) includes computer instructions which, when executed request a title from video server 250 
and control decoding and display of the decoded motion video signals by decoder 204 and is shown in greater detail 
in Figure 4. The computer instructions of applet 212 are organized into various levels, each of which defines a respective 
component of the behavior of applet 212. Applet 212 includes a player level 402. an API level 404. a decoder level 

JO 406 and a detailed decoder level 406. 

Player level 402 includes computer instructions which, when executed implement a graphical user interface in 
which a user can control the bit stream received by video server 250 (Figure 2) and the display of the decoded motion 
video signals of the bit stream by physical manipulation of one or more of user input devices 120 (Figure 1). In one 
embodiment, the computer instructions of player level 402 (Figure 4). when executed cause graphical and/or textual 

*5 representation of control mechanisms to be displayed in one or more of computer display devices 1 30 (Figure 1 ). Such 
control mechanisms are krcwn and conventional and include without limitation, virtual buttons pull-down menus 
virtual radio buttons virtual check boxes and sliding scroll bars In a conventional manner, a user activates one or 
more of such control mechanisms by physical manipulation of one or more of user input devices 120 {Figure 1) and 
such physical manipulation results in receipt by player level 402 (Figure 4) of applet 21 2 of signals and/or data repre- 

50 senting such activation 

API level 404 includes computer instructions which, when executed, implement the RPC protocol of API 252 (Figure 
2) of video server 250 and invoke RPC calls to API 252 to control the bit stream transmitted by bit pump 254 in ac- 
cordance with interaction of a user with the graphical user interface implemented by player level 402 (Figure 4). 

Decoder level 406 and detailed decoder level 406 collectively control operation of decoder 204 (Figure 2). generally 

5$ controlling the decoding of the bit stream received from video server 250 by decoder 204 and the display in a computer 
display device of the decoded motion video image. Decoder level 406 includes computer instructions and data struc- 
tures which are not specific to any particular decoder, while detailed decoder level 406 includes computer instructions 
and data structures which are specific to decoder 204 )t is generally preferred that detailed decoder level 406 is as 
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small and simple as possible such that the majesty of computer instructions of decoder levels -OS and 408 are included 
in decoder level 406 Accordingly adapting applet 212 (Figure 2) to operate in conjunction v.-th a decoder other than 
decoder 204 requires modification of only detailed decoder level 405 and. therefore, as little rnodiftcation as possible 
Appendix A is a computer source code listing of a preferred embodiment of applet 21 2 The modules of Appendix 

5 A are written in the Java applet computer instruction language developed by Sun Microsystems Inc. of Mountain View. 
California. The computer instructions of the Java applet computer instruction language are coject-onented. and each 
of the modules of Appendix A represents a respective class of objects. Player level 402 (Figure 4) in this embodiment, 
includes classes SunMediaCenterPlayer. Player, and PositionSlider as defined in the computer source code listing of 
Appendix A. API level 404. in this embodiment, includes classes MsmPlayer. MsmSession. MsmAccessRight. Msm- 

10 Persistence. MsmPlaylist. MsmToStrtng. Msmifenr MsmTitleltem. MsmDeadAirltem. MsmException. XdrBfock : and 
PortMapper as defined in the computer source code listing of Appendix A. Decoder level 406. in this embodiment, 
includes classes Decoder and Decoderlmpl as defined in the computer source code listing of Appendix A. Detailed 
decoder level 408. in this embodiment, includes class MpxDecoderlmpI as defined in the computer source code listing 
of Appendix A. 

1 ? In the preferred embodiment of the present invention defined by Appendix A. a module •loop" includes computer 

instructions of the C computer instruction language and defines a loop computer process which executes independently 
of multimedia document viewer 202 (Figure 2) The loop computer process cooperates with multimedia document 
viewer 202 and decoder 204 to request and receive from video server 250 bit streams representing multicast motion 
video signals. 

20 The above description is illustrative only and is not limiting. The present invention is therefore defined solely and 

completely by the appended claims together with their full scope of equivalents. 
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APPEfVDlX A 



SunMediaCenterPlayer 
/* 

w * e (#) SunMediaCenterPlayer . java 

* 

* Copyright 19S5 Sun Microsystems, Inc. All Rights Reserved. 
+ 

* version 1 . 0 

is * author Christopher Lindblad 

*/ 

import java . applet . *; 

20 import java. awe.*; 

import j ava . net . * ; 

import j ava . io . * ; 

import COM . Sun . isg . smc j c . * ; 



25 
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public class SunMediaCenterPlayer extends Applet { 
■private Player player ; 
private TextArea reporter ; 
private Thread thread; 

public SunMediaCenterPlayer ; { 
setLayout (new 3orderLayout ( ; ) ; 
player = new Player (); 
add("Cen:er", player) ; 



public synchronized void in it ( ) { 
if [reporter I = null reporter . getParent ( ) = = this) { 
remove ( reporter ) ; 
40 reporter . set Tex t ( " " ) ; 

validate ( ; ; 



x 

try 



50 



int port =get Parameter In t l "por:", - 1 ) ; 
mt vc-cet Parameter Int ( "v:" , - L } ; 
if (vc:=-l) ( 
player . ini t ( 

getParame terRequired { "host " ) , 
getParameterRequired ("title" ) , 
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getParameterLong ("start" , 0L) , 
get Parameter Long ("duration", 0L> , 
get ParameterSt ring ( "loop" , 
lse") . equals IgnoreCase ( "true" ) , 

getParameterString ("cmd" , "play") , 
get Parameter Image ("img", null) , 
vc / 11 " / 

getParameterURL ( "CC" ) , 
getParameterRequired { " interface" ) ) ; 
}else{ 

xf (port==-l) { 
player . init ( 

getParameterRequired ( "host " ) , 
getParameterRequired ( "title" ) , 
getParameterLong ("start"/ 0L) , 
getParameterLong { "duration" , 0L) , 
getParameterString ( " loop" , 
lse" ) . equals IgnoreCase ( "true" ) , 

getParameterString ("cmd", "play") , 
get Parameter Image ("img", null) , 
port, " 

getParameterURL ("CC") , null) ; 
} else { 
player . init ( 

getParameterRequired ( "host" ) , 
"none", 0L, 0L, false, "play", 
get Parameter Image ( " img" , nul 1 ) , 
port, 

getParameterRequired ( " format" ) , 

getParameterURL ("CC") , null) ; 

} 

} 

} catch {IOException e) { 

report (e, "parsing Sun MediaCenter player parame 

} _ 

} 

public synchronized void start () { 
try player . start () ; catch (IOException e) 

report (e, "starting a Sun MediaCenter player"); 



public synchronized void stop!) { 
try player . stop ( 5 ; catch (IOException e) 

report (e, "stopping a Sun MediaCenter player"); 

} 
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private String getParameterRequired ( String key) throws 
lOExcepticn { 

String vai = getParameter ( key ) ; 
if (val != null) return val; 

throw new IOException ( "missing required parameter " + key) 

} 

private int getParameter IntRequired { String key) throws 
lOExcepticn { 

String val = getParameter ( key ) ; 
if (val != null) 

try return Integer .parselnt (val) ; catch 
( Number Forma t Except ion e ) 

throw new IOException ( 

".parameter " + key + ,f is not a valid int: " 

vai) ; 

throw new IOException ( "miss ing required parameter " + key) 

} 

private URL getParameterURL (String key) { 
URL res-nul 1; 
String val = getParameter ( key ) ; 
if (val == null) return null; 
try res=new URL { val); 

catch (MalformedURLException e) try res=new 
URL (getDocumentBase ( ) , val) ; 

catch (MalformedURLException f) 
System. out .print In ( "MalformedURLException" ) ; 
return res; 

} 

private String getParameterSt ring ( St ring key, String dflt) 
String val = getParameter ( key ) ; 
if (vai == null) return dflt; 
return va 1 ; 

} 

private int getParameter Int (String key, int dflt) throws 
IOException { 

String val = getParameter ( key ) ; 
if (vai == null) return dflt; 
try return Integer . parselnt (val ) ; catch 
(NumberFomatExcept ion e) 

throw new IOException ( 
"parameter " +*key + " is not a valid mt: " + vai); 

} 
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private long getParame terLonc (String key, long dflt) throws 
IOException { 

String val = getParameter ( key ) ; 
if (val == null) return dflt; 

try return Long .parseLong (val ) ; catch (NumberFormatExcept ion 

e) 

throw new IOException ( 
"parameter " + key + " is not a valid long: " + val); 

} 

private Image getParameterlmage ( String key, Image dflt} { 
String val = getParameter ( key) ; 
if (val == null) return dflt; 
return get Imag£ (ge tDocumentBase ( ) , val); 

} 

private synchronized void report (Except ion e, String doing) ( 
ByteArrayOutputStream os = new ByteArrayCutputS t ream ( ) ; 
Prints tream ps = new Prin:Stream(cs) ; 
ps. print ("An error occurred while " ) ; 
ps .print (doing) ; 
ps.printlrK" : " ) ; 
e . printStackTrace (ps) ; 
if (reporter — null) { 

reporter = new TextArea ( " " ; ; 

reporter . setEditable (false) ; 

) 

reporter . appendText (os . tcString ( ) ) ; 
if (reporter .getParent () != this) { 

add ("North", reporter) ; 

validate ( } ; 

> 
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Plaver 



* @ {¥ ) Player. java 

* Copyright 1995 Sun Microsystems, Int. All Rights Reserved. 

* version l.lsc 

* author Christopher Lindblad ( Msn API & Mpx API ) 

* author Stephane C AC HAT (Closed Caption * Multicasting) 



package COM, Sun. isg. smcic; 

import java. applet . * ; 

import java . awt . * ; 

import java.io.*; 

import j ava . net . * ; 



public class Player extends Panel implements Runr.able 

private long playDuraticn; 

private long startOffset; 

private long seek?osit:cn; 

private long tellPositicn; 

private double tellPositiond; 

private MsmPlayer player; 

private String host; 

private String titleName; 

private String msg; 

private String format; 

private Image img; 

private Thread thread; 

private Panel controlLine; 

private Panel contrcIBut tons ; 

private TextArea reporter ; 

private Decoder decoder; 

private PositionSiider posi tionSl ider ; 

private Buttonf] buttons; 

private int end = 999; 

private int initialCmd; 

private int port; 

private boolean loop; 

private boolean Msm; 

private URL CC; 

orivate List CCt; 
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20 



25 



private int CCz=0; 

private String [ 3 CCb=new String ; 1024 ] ; 

private Doublet] CCi=new Double [ 1024 ] ; 

5 private int CC1=0; 

private int CCc^O; 

private int CCm=0; 

private boolean playing = false; 

private TexcFieid CCs; 

w private String ATM; 

public Player () { 
setLayout (new BorderLayout ( ) ) ; 
decoder = new Decoder (); 
15 add ("Center" , decoder); 

) - u 

public synchronised void init( 
Siring host, String titleName, 

long startOffset, long playDuration, boolean loop, 
String cmd, Image irng, int pore, String format, URL CC,£cr:ng 

ATM ) 

throws IOException { 

URLConnecticn uc; 
Double d; 
String str; 
int i = 0; 
int j=0; 

30 

this . port=pcrt ; 

if ( (port !=-!)&& (ATM==r.uli) ) { 

Msm=f alse; 
} else { 

35 Msm-true; 

this . ini tialCmd = parseCrr.d (cmd ) ; 

} 

this ,CC=CC; 
this .ATM= ATM; 
*° this, host = host; 

this . titleName = titleName; 
this . startOffset - startOffset; 
this . pi ay Dur at ion = playDuration ; 
this. loop = loop; 
45 this . img = img; 

this . format = format; 
if (CC!=null) { 
CC:= new List ( ) ; 
CC z .minimumSi ze ( 5) ; 

o0 
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CCt . pref erredSize (6) ; 
uc- CC . openConnection { } ; 
Data Inputs t ream in=new 
Da talr.outStream iuc . get Input St ream ( ) ) ; 
str= M - n ; 
CCb[i]=new Str ing ( " * " ) ; 

CCi [ i ] =new Doubie(O.O); 

while (in, available ( ) >0) { 
str=in . readLine ( ) ; 
while 

( ( str . trim ( ) . length ( ) ==0) (in . available ( ) >0) ) str-in . readLine ( ) 

if (str !=null) { 

j=s tr . trim ( ) . indexOf ( ' ' ) ; 
if (3>0» { 

CCb [ i ] =new String ( str . substring ( j + 1 ) ) . trim ( ) ; 
CCt . a del tern (CCb [ i ] ) ; 
if (CCb[i]==nuil) CCbf i] = *' * " ; 
CCi [ i] -new Double (str . substring (0, j ) . trim ( ) ) ; 
i + + ; 

} 

\ 

) 

CCm=i-l; 
in . close ( ) ; 

} 

} 

public synchronized void start;) throws IOException { 
if (reporter !- null reporter . get Parent ( ;■ -= this} { 
remove (reporter) ; 
reporter . setText ; " " ) ; 
val idate ( ) ; 

} 

if (thread == null} • 
cmd = initialCnd; 
thread = new Thread ( this ) ; 
thread . start ( ) ; 

t 



public synchronized void stop() throws IOException ! 
* if (thread 1 = null) { 

thread = null; 

notify ( ) ; 

} ' 
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public synchronized boolean action (Event evt, Object arg) { 
if (buttons != null && evt. target instaneeof Button) { 
3uttcn b = (Button) evt . target ; 
for (mt i = 0; 1 < buttons . length; i + +) { 
if (b == buttons [i]) citid = i; 

) 

notify ( ) ; 

if (CC != null evt. target ==CCt ) { 

seekPosition = (long) (new 
Double (CCi [CCt . getSelectedlndex ( ) ] .dcubleValue 0*10) . intValue ( ) ) 
100000000; 

cmd = SEEK; 

notify ( ) ; 

} ; - * 

if (CC != null && evt - target==CCs) { 
if (CCKCCm) { 

CCz=CCl+l; 
} else { 
CCz=0; 



while [ (CCz!=CCl) && (CCbFCCz] .indexOf XCs.getText () 5 <0) ) { 
CCz++; 

if (CCz>CCm) CCz=0; 

if (CCb [CCz] . indexOf (CCs .getText • ) ) >=0) { 
CCt . select (CCz ) ; 
CCt .makeVisible {CCz+ 1 ) ; 
seekPosition - (long) (new 
Double (CCi [CCt . getSelectedlndex () ] .doubleValue 0*10) . intValue O ) 
100000000; 

end = SEEK; 
notify ( ) ; 

1 
/ 

return true; 

} 

privace void setConr.ec t (MsmConnect cormec:) throws 
IOExcepticn { 
try • 

player . setConnect [connect ) ; 
} catch (Ms.Tlxcep::or. e} { 

/- Try it with destTiAddr in beta 0.5 syntax. */ 
System. out .println ( "DesTiAddr= M *connect . desrTiAddr) ; 
Inou tS t r earn is = new 
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StringBuffer Input St ream (connect . destTiAddr ) ; 

StreamTokenizer st = new StreamTokenizer ( is) ; 
String host; 
int udpporu; 

if (A7M==nuli) ! 
if (st .nextToken ( ) == St reamToker.i zer . TT_WORD 
st .svai .equals ("host") 
st .nextToken ( ) == ' = ' 

st . nextToken ( ) == StreamTokeni zer . 7T_W0RD 
(host = st.sval) ! = null 
st . nextToken ( ) == ',' 

st .nextToken ( ) = = StreamTokeni zer . 7T_W0RD 
st . sval . equals ( " udpport " ) 
st .nextToken ( ) == *=' && 

st .nextTakenO = = StreamTo keni ze r . TT_NUMBER 
(udpport = (int) st .rival) ! = 0) • ( 
connect .destTiAddr = "beO, " + host^'\ " + udpport; 
player . set Connect (connect ) ; 

} else { 
throw e; 

} 

}else{ 

throw e; . . 

) 

) 

} 

public synchronized void runt) { 
Thread currentThread = Thread . cur rentThread () ; 
MsmSession session = null; 
MsmTitle title = null; 

Msmltern[; items = null; 
int speed=3 ; 



if (Msm) { 

cor.trolButtcns = new Panel;) ; 
contrciBuctons . set layout ! new FiowLaycut ( ) » ; 
contrc-13uttons . add (ends [ PAUSE] , new 
3ut ton (labels [ PAUSE] ; ) ; 

contrciLine = new Panel (); 

contrciLine . setLayout -new BorderLayouc ( s ! ; 
contrzlLine . add « "East " , cont roi3ut tons ) ; 
position Slider = new Pos i tionSi ider { this ) ; 
control Line . add ( "Center" , posi tionSlider ) ; 
add ( "South" , conrrolline) ; 
if (CC ! =nuli) { 
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Panel CCp-new Panel (); 
CCp . setLayout (new 3orderLayout ( ) ) ; 
Panel CCc^new Panel (); 
5 CCq . setLayout (new 3orderLayou t t ) ) ; 

CCs- new Text Field ( 1 5 ) ; 
CCs . isEditable ( ) ; 
CCq . add ( " South" , CCs ) ; 
w Label l=new Label ( "Search" ) ; 

CCq. add ("Center", 1) ; 
CCp. add ("East", CCq) ; 
CCp. add ( "Center", CCt) ; 
controlLine . add ( "North" , CCp) ; 
15 \ 

) - * 

"ry { 

if (Msm) { 

items = new Msnltem[l]; 
20 session = new MsmSession (host ) ; 

title = session . cetTi tleStatus ( ti cleNaxe) ; 
if (playDurat ion =- OL) playDuration = 
title . totaiPiayDuration; 

f ormat=ti tie . format ; 

} 

decoder . in it (format , img, host , port, ATM) ; 
if (Msm! { 

titlelmt (title) ; 
3Q player = new MsmPlayer (session, info(), 

MsmPiayer . TIME_MAXTIME) ; 

player, set Persistence (new MsrnPersistence { 

* MsmPersistence . T YPE_N0NE, 
MsmP layer . TIME_MAXTIME) ) ; 

js items (01 = new Msmli tleltem ( 

tuleNarp.e, playDuration, startOffset, playDuration, 
playDuration, false, true, t i t le . maxBi tRa te ■ ; 
player, set Play list (new Msrr.Piaylist ( 

* MsnPlayer . TIME_CURRENT, loop, 0, 
40 MsmPlayer . TIME_MAXT 1ME , 

items, 0, 0) ) ; 
setConnect :aew MsnConnec t ( 
decoder . destTiAddr ( ) , decoder . encap ( } , 
title . maxBitRate) ) ; 
" 5 playing = raise; 

speed = MsmPlayer . 5PEED_FCRWARD; 
}else\ 
invalidate ( ) ; 
validate { ) ; 
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while (currentThread « thread) { 
switch (ciud) { 
case NOP: { 

if (Msm) { 

MsmPiayStatus status = 

player . getPlayStatus ( ) ; 

if ( tellPosi t ion != status . curreniPosit ion) 
teilPosition = status . currentPosit ion; 
posit ionSiider . reoaint ( ) ; 

} 

tellPosi tiond= (teilPosition/ 1000000 000) + 3.0; 

if (CC!=null) i 
. - CCo=CCl; 

while 

( (CCi [CCi+1] .doubieValue () <tellPpsi t iondi (CCl + KCCm) ) CC1 + 

while 

( (CCi [CCi] .doubieValue () >tell?ositiondi && (CC1>0) ) CCI--; 

if (CCo ! =CC1 > ( 

CCt .select (CCI-l) ; 
CCc .make Vis ible (CCI ) ; 

} 

} 

player . setPersis tence (new MsmPersistence ( 
MsmPersistence . TY?E_NONE, 
status .currentDate+5C-1000000000L) } ; 

} 

break; 

} 

case PAUSE: { 

decoder .pause () ; 

if (Msm) player .pause (MsmPlayer . TIME_CURR£NT> ; 
decoder . flush ( ) ; 
playing = falser- 
decoder . play ! ) ; 
break; 

case GOTO_START: { 

teilPosition = 0L; 

i f [Msm) posi tior.Siider . repaint ( ) ; 
decoder . stop ! ) ; 

i f 'Msm) player . plav (Msrr.Player . S P E E D_ FORWARD , 
0L, " - 

0L, 

MsinPiayer . TIMEJCURRENT) ; 
decoder . flush ( ) ; 
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break; 

} 

case GOTO_END: { 

tellPosition = piayDurat ion; 

if (Msm) positions lider . repaint ( ) ; 

decoder . stop ( ) ; 

if (Msm) player .play (MsmPiayer , SPEED_REVERSE, 
piayDuration, 
0L, 

MsmPiayer. TIME_CURRENT) ; 
decoder . flush ( ) ; 
break; 

} 

case SEEK: { 

tellPosition = seekPosition; 
if (Msm) positions lider . repaint ( ) ; 
if (playing) { 
decoder . flush ( ) ; 
if (Msm) player .play (speed, 
seekPosition, 
MsmPiayer . TIME_MAXTIME, 
MsmPiayer . TIME__CURREN7) ; 

} else { 
long duration = S E EKDURAT I ON ; 
long position = seek Posit ion- duration ; 
if (position < OL) { 

duration += position; 
position -= pos i t ion; 

} 

decoder . play ( ) ; 
decoder . flush ( ) ; 

if (Msm) player .play (MsmPiayer . SPEED_FORWARD, 
position, 
duration, 

MsmPiayer. TIME_CURRENT ) ; 

} 

break ; 

} 

default: { 

decoder .play ( ) ; 
decoder . flush ( ) ; 
if (Msm) { 

speec = cmd; 
player. play (speed, 

MsmPiayer . TIME_CURRENT, 
MsmPiayer . TIME_MAX TIME, 
MsmPiayer . TIME CURRENT); 
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playing = true; 

if (CC ! =null) 

if (CCo!=CCi) ( 

CCt . select (CC1- 1 ) ; 
CCt .makeVisible (CCD ; 

} 

} 
} 

cmd = NOP; 

try wait (100); catch ( InterrupteciExcept ion e) ; 

} 

} catch (Exception e) { 

report (e r "communicating with a Sun MediaCenter 
server" } ; fc 
} finally { 

try { 

try decoder . stop () ; catch {Exception e) 

report (e, "shopping a video decoder"); 

if (Msm) { 
if (player : = null) { 

try player . delete ( ) ; catch (Exception e 
report ;e, "deleting a Sun MediaCenter 

player" * ; 

player = null ; 
} 

} 

} finally { 

if (Msm) { 
if (session !- null) { 

try session .close () ; catch (Exception e 
report (e, "closing a Sun MediaCenter 

connection" ) ; 

i 

\ 
i 

) 

} 

} 

/* 

* Callback from the Posit ionSl ider . 

* Unsynchronized :o avoid deadlock. 

* @return value between 0 and 1 indicating where m 
we are. 

-/ 

public double tell ( ) { 
if (playDurat ion == CD return COD; 
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return (double) tellPosition / (double) playDuration; 

) 

/* 

* Callback from the PositionSlider . 

* Seek to a relative position in a file. 

* @param position Value between 0 and 1 

* indicating where in the file to go. 
*/ 

public synchronized void seek (double position) { 
if (playDuration — 0) return; 

seekPosition = (long) (position*playDuration) ; 
cmd = SEEK; 
notify 0 ; 
} - * 

private String infcd throws UnknownHcs tExcept ion { 

String hostName = 
InetAddress . getLocalHost ; ) . getHostName ( ) ; 

String j avaVersion = System . get Property ( " j ava .version") 

String javaVendoz = System . getProperty ( " j ava . vendor' 1 ) ; 

String osArch - System. getProperty ( "os . arch" ) ; 

String osName = S ystem. get Property ( "os . name ") ; 

String osVersion = System. getProperty ("os . version" ) ; 

return hostName 

+ M Java " + j avaVersion + M ( " + javaVendor + ) 
+ " ('* + osArch + " " - osName + " " + osVersion + 



private void addButton (int i) { 
buttcnsfi] = new Button ( labels [ i ]) ; 
con troiBut tons . add (cmcs [i ] , burtons [ i ] ) ; 

} 



/** 

* Initialize for a title. 

* @param title The title to play. 
*/ 

private void titlelni t (MsmTitle title) throws lOException { 
controlBut tons . re.TtoveAli ( ] ; 
buttons = new Button ' labels . length ■ ; 
for (int i = MsmPlayer .S?EED_SLOWEST_FC?.WA?.D; 

i < = MsmPlaver .S?EED_SCENE_FORWARD; 

i + { 

if (title . speedScale [ i ] != 0) ( 
addButton (GOTO S TART ) ; 
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break; 

} 

for (int i « MsmPlayer . S?EED_SCENE_REVERSE ; 
i <= MsmPlayer . SPE£D_S LOWES 7_RE VERSE ; 
i + +) ( 

if {title. speedScale[i) != 0) acdButton ( i ) ; 
addButton (PAUSE) ; 

for (int i = MsmPlayer . SPEED_SLOWEST_FORWARD; 
i <= MsmPlayer . SPEED_SCENE_FORWARD; 
i + +) { 

if (title. speedScale[i] ! = 0) acd3utton ( i ) ; 

} 

for (int i = HsmPlayer . SPEED_5CENE_REVSRSE ; 
i <= MsmPlayer . 5PEED_SLOWEST_REVERSE ; 
i + +> { 

if (title. speedScalet i] = 0) { 
addButton !GOTO_END) ; 
break; 

} 

} 

/* recompute layout */ 
control Line . invalidate ( ) ; 
invalidate C } ; 
validate ( ) ; 

/* resize if we need to */ 
Component c = getParent{); 
while (c !- null) { 

if (c instanceof Applet) { 

Dimension ps = c.preferredSize ( ) ; 

Rectangle b = c. bounds (J; 

if (ps. width != b. width || ps. height != b. height) 
// This wedges Netscape Navigator 2.0 
// c . resize (ps . width, ps. height) ; 

break; 

} 



private void report (Exception e, String doing) 1 

3y teAr rayOutpu tS cream os = new By teArrayOutpu tStrean ( ) 

PrincScream ps = new Prints t ream (os ) ; 

ps . print ( ff An error occurred while " ) ; 

ps .print (doing) ; 
- ps .print In ( " : " ) ; 
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e . printStackTrace (ps ) ; 
if {reporter == null) { 

reporter = new TextArea ( " " ) ; 

reporter . set Editable (false ) ; 

} 

reporter . appendText (os. toString ( ) ) ; 
if ( reporter . getParent ( ) != this) { 

add ( "North" , reporter) ; 

validate ( ) ; 

} 

} 



private int parseCmd ( S t r ing cmd) throws IOException { 
for (int i = 0; i < cmds . length; i++) { 

if (cmd . eq^ualsIgnoreCase (cmds [ i ]) ) return i; 

} 

throw new IOExcept ion ( "No t a valid Player command : "+cmd) 

} 

private static final long SEEKDURATION = 400QOOOOOOL; 



private static final 

private static final 

private static final 

private static final 

private static final 



int PAUSE = 16; 
int GOTO_START = 17; 
int GOTO_END = 18; 
int SEEK = 19; 
int NOP = 20; 



rivate static 


final StringM labels = { 


n !<<<<", 


// 


MsmPlayer . SPEED SCENE REVERSE 

// MsmPlayer . SPEED FASTEST REVERSE 


"««" , 




"<«" , 




// MsmPlayer .SPEED FASTER REVERSE 


"« ,, / 




// MsmPlayer .SPEED FAST REVERSE 




// 


MsmPlayer . SPEED_REVERSE 


" 1 < u / 




// MsmPlayer . SPEED SLOW REVERSE 


" 1 !< M , 




// MsmPlayer .SPEED SLOWER REVERSE 


" 1 1 i < " / 




// MsmPlayer .SPEED SLOWEST REVERSE 


" > i 1 1" , 




// MsmPlayer . SPEED SLOWEST FORWARD 


" > 1 1" , 




// MsmPlayer . SPEED SLOWER FORWARD 


" > 1" / 




// MsmPlayer . SPEED SLOW FORWARD 




// 


MsmPlayer . SPEED FORWARD 


">>" , 




// MsmPlayer . SPEED__FAST FORWARD 


"»>", 




// MsmPlayer .SPEED FASTER FORWARD 


">>>>" , 




// MsmPlayer . SPEED__FASTEST FORWARD 


" >>>> ! " , 


// 


MsmPlayer . SPEED SCENE FORWARD 


"II", 




// PAUSE 


" | |<<<<", 


// 


GOTO START 


"»»! | 


// 


GOTO END 



f 
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J5 



20 



25 



35 



40 



50 



55 



// SEEK 

// NOP 

} ; 

private static final String!} cmds = ! 

"scene_reverse M , // MsmPlayer . SPE£D_SCENE_REVZRSE 

"fastest^reverse", // MsmPlayer . SPEED_FASTEST_REVERSE 

f, faster_reverse'\ // MsmPlayer . SPEED_FASTER_RZVERSE 

"fast_reverse" , // MsmPlayer . SPEED_FAST_REVERSE 

"reverse", // MsmPlayer . SPEED_REVERSE 

"slow^reverse" , // MsmPlayer . SPEED_SLOW_REVERSE 

"slower^reverse"', // MsmPlayer . SPEED_SLOWER_R£VERSE 

"slowestjeverse", // MsmPlayer . SPEED_SLOWEST_REVERSE 

"slowestjorward", // MsmPlayer . SPEED_SLOWEST_FORWARD 

"slower^forwa^d", // MsmPlayer . SPEED_SLOWER_FORWARD 

"slowjorward", // MsmPlayer . S?EED_SLOW_FORWARD 

"play", // MsmPlayer . SPEED_FORWARD 

"fastjorward", // MsmPlayer . 5 ? E £ D_ FAS T FO R WAR D 

"faster^forward" , / / MsmPlayer . S?ESD_FASTER_FQRWARD 

" f as test_forward" , // MsmPlayer . S?E£D_FASTE3T_FORWARD 

"scene^forward", // MsmPlayer . SPEED_SCENE_FORWARD 
"pause", // PAUSE 

"goto_start", // GOTO_START 

M goto_end" , // GOTO_END 

"seek 1 ' , // SEEK 

" hod " , // NO? 

}; 
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PositionSlidcr 

/* 

* 8 (#) Posit ionS I icier . java 

* Copyright 1995 Sun Microsystems, Inc . Ail Rights Reserved . 
★ 

* version 1 . 0 

* author Christopher Lindblad 
*■ 

*/ 

package COM . Sun . isg . smcj c ; 

import java.awt.*; * 
import j ava . io . * ; 

class Positions 1 ider extends Canvas { 
private Player player ; 
private int hgap; 
private int vgap; 
private int wid; 

public PositionSlider (Player player) { 
this (player, 5, 5, 6); 

} 

public PositionSlider (Player player, int hgap, int vgap, int 
wid) { 

this . player - player ; 
this. hgap = heap; 
this . vgap = vgap; 
this. wid = wid; 

} 

public void update (Graphics g) { 
paint (g) ; 

} 

public synchronized void paint (Graphics g) { 
Rectangle r = bounds () ; 

int position = (int) ( (r . width -hgap * 2 ) "player. tell () ) +-hgap; 

g. setCoior (getBacfcground * ) } ; 

g. f lllRect (0, 0, r . width, vgap* 2) ; 

g . f ll IRect ( 0, r , height -vgap* 2 , r . width, vgap* 2 ) ; 

g.fillRect(0, vgap*2, r . width-hgap* 2 , r . heigh t- vgap* 2 ! ; 
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g. fillRect (r . wicth-hgap, vgap*2, r .width, r . height-vgap* 2 ) 
g. fill3DRect (heap, vgap*2, r . width-hgap* 2, r . height-vgap* 4 
alse) ; 

g . f il!3DRect (position-2, vgap, wid, r . he ight- vgap* 2 , true) 

} 

private synchronized void seek(int x) i 
Rectangle r = bounds () ; 

double position = ( (double) (x-hgap) ) / 
(double) ( r . width-hgap*2 ) ) ; 

if (position < 0.0D) position = 0.0D; 
if (position > 1.0D) position = 1.0D; 
player . seek ( position) ; 

) 

it. 

public boolean mouseDown (Event e, int x, int y) { 
seek (x) ; 
return true; 

> 

public boolean mouseDrag (Event e, int x, int y> ( 
seek (x) ; 
return true; 
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MsmPlaver 

/* 

* @ ( # ) MsmPlaver . j ava 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 

* version 1.0 

* author Christopher Lindblad 

*/ 

package COM .Sun. isg . smc jc; 

import java.io.*; * 

/** 

* Media Stream Manager Client API 

* MSM allows for the creation of "players". A player is a 
persistent entity 

* that provides for the scheduled delivery of isochronous data 
to a 

* particular destination. To accomplish this task, a player 
maintains a 

* playlist of titles, the state of a "playhead" which traverses 
this 

* playlist, and an access list controlling who can perform 
various functions 

* on the player . 

* MSM, when supplied with titles that have been prepared for 
presentation at 

* multiple presentation rates, manages the position index 
lookups and stream 

* switching necessary for "trick play". 

* Associated with a player is a "playhead" that maintains a 
destination for 

* the isochronous data (possibly different than the controlling 
client) and a 

* "playPosi t ion" which travels along the playlist at the 
selected 

* presentation rate and delivers isochronous data as scheduled 
to the 

* destination. The position, presentation rate, and 
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15 



20 



25 



30 



40 



45 



50 



presentation direction 

* of the playhead car. be controlled via playO, paused , and 
resume ( ) . The 

* initiation of play can be synchronized with "wall clock time" 
via play ( ) ; 

* presentation will then stay synchronized with wail-clock time 
as long as 

w presentation rate and direction are Normal-Rate, 

Forward- Direct ion . 
★ 

* Latency from invocation of the play() request until actual 
start of stream 

+ may be reduced by "pre-rolling" with a playO request that has 
zero 

* duration. This jnay also be used to set a current piaylist 
position without 

* actually starting play. 

* MSM manages concurrent updates to a piaylist by returning a 
modification 

. * timestamp with piaylist status. The modification time stamp 
indicates the 

* time of the last modification of the piaylist. When a client 
wishes to 

* update a piaylist, the client will first ob:a:r. status 
containing a 

* modification timestamp to understand the current state cf the 
piaylist. 

* Based on this status, the client then determines the 
appropriate upda t e s 

* and passes those updates along wich the modification time stamp 
of the 

* status on which the updates were based tc msm. If msn finds 
-hat the 

* modification timestamp has not changed, implying that the 
clients updates 

* are b---6ed on currently valid piaylist state, the piaylist 
update will 

* succeed. If the modification times tamp indicates that the 
piaylist has 

* been modified since this client obtained status, the update 
will be 

* rejectee. In this case, the client should reobtam status, 
reaccess the 

* update, and then if appropriate resubmit the update with the 
modification 

* time stamp of the new status. There is a designated timestamp 
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that forces 

* playlist modifications, this may be used if some external 
method of 

* concurrency control is preferred. 

* MsmPlaylist may be edit while play is in progress. Ncrmally, 
changes to the 

* playlist will not take effect until the current item m play 
completes. A 

* playlist modification can be forced to take effect immediately 
by calling 

* resume (). resume (} should be called with the speed argument 
being the 

* current (or desired new speed) and the s tartPosi tion argument 
being * 

* TIME_CURRENT . If the contents of the playlist at the current 
pes it ion of 

* the playhead have not been modified, this call will not 
disturb the 

* outgoing data stream. 

* MSM optionally maintains players persistently across server 
outages . When 

* this option is selected, a successful return from a player 
request 

* indicates that the player modifications have been made 
persistently. 

* Persistent players may optionally restart play on state 
recovery, play may 

* be restarted at the last played position or at the position 
that the 

* position that play would be add had r.c outage occurred. 
* 

* Access to read and modify players is control iec by access 
control lists 

* associated with the players. These may be modified by 

* msmPi werSetAccess ( ) . 
*■ 

* Access rights are "Read", "Control", and "Admin". Read rights 
ail state to 

* be seen. Control rights allow " trick-play" operations to be 
control led. 

* Admin rights allow creation of players, and connection, 
access, and 

* persistence attributes of players to be set. Access rights 
are associated 

* with "agents" (eg users; appropriate for the authorization 
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mechanism 

* selected. The reserved agent name ■'*" represents ALL agents, 
those 

* granting a right to , grants the right to ail agents. 
*/ 

public class MsmPlayer ( 

private MsmSession session; 
private byte [ ] handle; 

/** 

* Creates a player. The player is initialized 
non-persistent . 

* @?arara session A server session. 

* gparam info ^Saved, but uninterpreted by server. May be 

null. 

Used to describe the player for administrative purposes 

* G pa ram terminateDa te Date at which player should be 
auto-deleted . 

* If TIME_KAXTIME , the player will never be auto-deleted, 
it must 

* be deleted via delete. 

* ^exception IOException If an error has occurred. 
*/ 

public MsmPlayer (MsmSession session, String info, long 
terminateDate ) 

throws IOException { 

this. session = session; 

XdrBlock call = session . newCal 1 ( P LAY E?._C RELATE ) ; 

call . xdrcutString (info) ; 

call . xdroutMsmTime (terminateDate} ; 

XdrBlock reply = session . rpc (call ) ; 

handle = reply . xdrinBytes 'KAXCLSLEN) ; 

repl y . cone ! ) ; 

/ 

MsmPlayer (MsmSession session, XdrBlock xdr- { 
this. session = session; 
handle - xdr . xdrinBytes ( HANDLE LEN) ; 

} 

void xdrout (XdrBlock xdr} { 
xcr . xdroutBy tes ( handl e , HANDLE LEN* ) ; 

) 

public MsmSession getSess icn ( ) { 
return session; 
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public byte { ] getHandle ( ) ( 
return handle; 

> 

/** 

* Opens an existing player. 

* @param session A server session. 

* Goaram handle An opaque handle to the player. 
*/ 

public MsmPlayer (MsmSession session, byte[] handle) ( 
this. session = session; 
this. handle = handle; 

} - * 

/** 

* Deletes the player. In progress play of the player 
stopped. 

* @exception IOExceotion If an error has occurred. 
V 

public void delete () throws IOExcepticn { 
XdrElock call = sess ion . newCall { PLAYER_DELETE ) ; 
this . xdrout (call ) ; 
session. rpc (cai 1 ) . done ( ) ; 

} 

/** 

* Modifies access control list for player. 

* Sparam rights The access modifications. 

* ^exception lOException If an error has occurred. 
*/ 

public void setAccess (MsnAccessRight ( ] rights) throws 
IOException { 

XdrBlock call = session. newCal I ( PLAYER_S £T ACCESS ) ; 
this . xdrout (call ) ; 
call . xdrcutlnt ( rights . length) ; 
for (mt i = 0; l < rights . length ; i + +) 
rights [ i ] . xdrout ( cal 1 ) ; 

session. rpc (call ) .done;); 

} 

/ * * 

v Get access control list for player. 

* @return The access modifications. 

* (^exception IOException If an error has occurred. 
*/ 
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w 



20 



public MsmAccessRight [] getAccessO throws IOException { 
Xdr3lock call = session . newCal 1 ( PLAYER_GETACCES5 ) ; 
this . xdrout [call) ; 

XdrBlock reply = session. rpc (call ) ; 
MsmAccessRight [ ] result = new 
MsmAccessRight [reply . xdnnlnt ( ) ] ; 

for (int i = 0; i < result - length ; i-+) { 
result[i] = new MsmAccessRight ( reply ) ; 

} 

reply . done ( ) ; 
return result; 

} 

. /*- 

* Sets persistence for player. 

~ @param prstp A MsmPer sis tence containing the persistence 
to be set . 

* ^exception ICException If an error has occurred. 



public void setFersistence (MsmPersistence prst) throws 
ICException { 

Xdr31ock call = session. newCail (?LAYER_SETPERSI3TENCE) ; 
this . xdrout (call) ; 
2$ prst . xdrout (call) ; 

session. rpc (call ) . done ( ) ; 

/** 

30 * Get persistence information for player. 

* ^exception IOException If an error has occurred. 
*/ 

public MsmPers is tence getPersistence ( ) throws IOException { 
XdrBlock call = session .newCail <?LAYER_GETPE?.SISTENCE) ; 
J * this . xdrout (call ) ; 

XdrBlock reply = session , rpc (call ) ; 

M sir, Persistence resul: = new MsmPersister.ee ( reply) ; 
reply . done { ) ; 
return result; 

} 

* Replaces a porticn of the playlist for this player. The 
portion to be 

4$ 

* replaced ana tr.e new titles to inserted are indicated via 
MsmPiayiist 

* struct pointed :o by playlistp. 

* ?param playiist A MsmPlaylist that indicates the period on 

so 
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10 



the playlist 

* to be ( re) scheduled and the new titles to place within 
that period . 

* @exceotion IOException If an error has occurred. 
*/ 

public void setPlaylist (MsmPlaylist playlist) throws 
IOException { 

XdrBlock call = session . newCai 1 ( ?LAYER_SETPLAYLIST ) ; 
this . xdrout (call ) ; 
playlist .xdrout (call) ; 
session. rpc (call ) . done { ) ; 

} 

15 /* + 

* Obtains a .pcyrtion of the playlist for this player. 

* @param start Posit ion The position within the playlist at 
which to start 

returning status. 

20 * @param playl istDurat ion The number of ailliseseconds cf 

the playlist for 

* which to return status. 

* ^exception IOException If an error has occurred. 
*/ 

public MsmPlaylist getPlaylist ( long startPosit ion, long 
playl ist Duration) 

throws IOException ( 

XdrBlock call = session . r.ewCall ( P1AYER_GETPLAYLIST) ; 
this .xdrcut (call) ; 
30 call .xdroutMsraTime (startPcsi tion) ; 

call . xdrcutMsmTime (playl i stDurat ion) ; 
XdrBlock reply - session. rpc (call) ; 
MsmPlaylist result = new MsnPlaylist ! reply ) ; 
reply . dene ( ) ; 
35 return result; 

} 

/** 

* Obtains the playlist for this player. 

* ^exception IOException If an errcr has occurred. 
*/ 

public MsTiPlayiist get Playl i st ( ) throws IOException { 
return get?layl is t "( TIME_ZIRC, TIME_MAXTIME ) ; 

45 

* MsmConr.ects a player to the specified destination address. 

* An error is return if play is in progress at the time of a 

50 



40 



CO 
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setConnect ( ) * 

* @param connect A MsmCor.nect instance containing a 
transport- independent 

* address string for the destination of Media Server data 
controlled 

* by this player. A ccnnectp of N"JL1 disconnects the 
player from the 

*■ current destination. 

* ^exception IOExcepcion If an error has occurred. 
*/ 

public void setCcnnect (MsmConnect connect) throws ICExceptio 

{ 

XdrBlock: call = session . newCall ( ?LAYER_SETCONNECT) ; 
this .xdrout (call) ; 
connect . xdrout^call) ; 
sess ion . rpc (call ) . done ( ) ; 

) 

/ + * 

* Get current connection for player. 

* Qexception IOException If an error has occurred. 
*/ 

public MsmConnect getConnect () throws IOExcepticr. { 
~ XdrBlock call = session. newCal 1 (PIAYE^GETCON^NE'CT) ; 
this - xdrout ( call ) ; 

XdrBlock reply - session. rpc ( call ) ; 
MsmConnect result = new MsmConnect (reply) ; 
reply .done ( ) ; 
return result; 

} 

/-* 

Schedules play to commence at startDate. Play 
T will begin at playiist start Position and continue for 
playDurat ion NTT 

* seconds or until paused. An error is returned if the 
player is not 

* connected. 

* Only one play!) command can be pending, a second playO 
overrides any 

* pending play ( ) . 

* @param speed The speed at which to play. 

* @param s tart?ositicn The position within the playiist at 
which to begin 

* play. TIME__CURREN? means the current play position. 

* Sparam playDura tion The duration of play. 

■TIME MAXTIME ■ indicates "forever". 
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25 
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40 
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* @param snartDare The wall-clock time of cay at which to 
begin play. 

A value of TIME — CURRENT means start play immediately. 
5 * ^exception IOExcept ion If an error has occurred . 

public void piay( 
in- speed, long st art Posit ion, long playDuration, long 
startDate) 
w throws lOException [ 

XdrBicck call = session . newCall ( PLAYER_?LAY) ; 
this . xdrout (call ) ; 
call .xdrout In t (speed) ; 
call . xdroutMsmTime (startPosit ion) ; 
15 call .xdroutMsmTime (playDuration) ; 

cal 1 . xdroutMsmTime ( s tart Date ) ; 
session . rpc (call ) . dene ( ) ; 

20 / * * 

* Pauses play on the player. 

* Only one pause () command can be pending, a second pause f ) 
~ overrides any pending pause () . 

* @param pausePos i t ion The position within the playlist at 
which to pause 

* playing. If current play position is later than 
pausePosi tion 

(taking into account the direction of play), play pauses 
immediately . 

A value of TIME_CURRENT means stop immediately. 

* @re turn The time at which play actually paused . 

* Sexcection ICExceot ion If an error has occurred . 
•/ 

public long pause ; long pausePosi t ion ) throws Except ion { 
XdrBlock call = session . newCail ( ?LAYER_PA"JSE ) ; 
this.xdrout(cali) ; 

call . xdroutMsmTime (pausePos it ion) ; 
Xdr31cck reply = session . rpc (call ) ; 
long result = reply . xdrinMsmTime ;> ; 
reply . done ( > ; 
return result ; 



* Resumes playing . Play will cent inue unt i 1 paused 

* or "he enc of the playlist (looped pla.yli.sts play 
forever) . 

* (5param speed The speed at which to resume play. 

so 
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* @param startPosition The position within the piayiist at 
which to 

* resume play. TIME_CURREN7 means the current play 
position . 

* @exceocion IOException If an error has occurred. 
V 

public void resume (int speed, long startPosition) throws 
IOException { 

XdrBlock caii = session. newCall ( PLAYER_RESUME) ; 

this . xdrout (call ) ; 

call . xdroutlnt ( speed) ; 

call . xdroutMsmTime (startPosition) ; 

session. rpc (call ) .done () ; 

} 

ic 

/** 

* Get play state for a player. 

* @return A MsmPlayStatus instance. 

* @exception IOException If an error has occurred. 
*/ 

public MsmPiaySta tus getPlayS ta tus { } throws IOException { 
XdrBlock call = session. newCal 1 (PLAYER_GETPLAYSTATUS) ; 
this .xdrout (call) ; 

XdrBlock reply = session • rpc (call) ; 
MsmPlayStatus result ~ new MsmPlayStatus { reply) ; 
reply. done {) ; 
return result; 

\ 

public String toStringO { 
return KsmToS tring . playerToSt ring ( this ) ; 

} 

private static final ir.t "HANDLE LEN = 12; 

public static final 

public static final 

public static final 

public static final 

public static final 

public static final 

public static final 

public static final 

public static final 

public static final 

public static final 



long T I ME ACT I ME = -IL 
long TIME_CURRENT = -2L 
long TIME_ZERO ~ = OL 
long T Z ME _KAX TIME = 21 4748364 7999999999L 
long TIME _M I N ? I M E = 1L 

ir.t S PEE D_SCENE_RE VERSE - 0; 
mt 5PEED_FASTES7_REVERSE ^ 1; 
int SPEED_r AS7ER_REVERSE = 2; 
int S?EED_FAST_REVERSE = 2 ; 
int S?EED_REVERSE = 4; 
mt SPEED SLOW .REVERSE - 5; 
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public static final int SPEED_SLOWER_REVERSE = 6; 

public static final int SPEED_S LOWES T_REVERSE = 7; 

public static final int SPEED_SL0WEST_F0RWARD = 8; 

public static final int SPEED_S LOWE R_ FORWARD = 9; 

public static final int SPEED_SL0W_FORWARD = 10; 

public static final int SPEED_FORWARD = 11; 

public static final int SPEED_FAST_FORWARD = 12; 

w public static final int S PEE D_FAS TE R_F0RWARD = 13; 

public static final int SPEED_FASTEST_FORWARD = 14; 

public static final int SPEED SCENE_FORWARD = 15; 



private 


static 


final 


int 


PROG = 


0x206d736d; 






private 


static 


final 


int 


VERS = 








private 


static 


-f inai 


int 


SERVER 


AUTHTYPE 




1 


private 


static 


final 


int 


PLAYER" 


"create 




2 


private 


static 


final 


int 


player" 


"delete 




3 


private 


static 


final 


int 


PLAYER 


"list 




4 


private 


static 


final 


int 


PLAYER" 


"SETACCESS 




5 


private 


static 


final 


int 


player" 


"getaccess 




6 


private 


static 


final 


int 


PLAYER 


"SETPERS ISTENCE 




7 


private 


static 


final 


int 


PLAYER 


"getpersistence 




8 


private 


static 


final 


int 


player" 


"setplaylist 




9 


private 


static 


final 


int 


PLAYER 


"getplaylist 




10 


private 


static 


final 


int 


PLAYER 


"SETCONNECT 




11 


private 


static 


final 


int 


PLAYER 


"getconnect 




12 


private 


static 


final 


int 


PLAYER 


"play 




13 


private 


static 


f inal 


int 


player" 


"pause 




14 


private 


static 


final 


int 


PLAYER 


"resume 




15 


private 


static 


final 


int 


PLAYER 


"getplaystatus 




1 6 


private 


static 


final 


int 


TITLE GETSTATUS 




17 



} 
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MsmSession 

w @ {#) MsmSession . java 

* Copyright 1995 Sun Microsystems , Inc . All Rights Reserved . 

ir 

10 * version 1.0 

* author Christopher Lindhlad 



is 



20 



25 



35 



40 



*/ 

package COM . Sun . isg . smc j c; 

import j ava . io . * ; - 
import java .net . * ; 
import java . util . * ; 

* Media Stream Manager Client API 



The Media Stream Manager (msm) API provides an RPC interface 
managing 

the scheduling and play of isochronous media streams. 



*/ 

public class MsmSession { 
30 private String serverHostName ; 

private Socket sockets- 
private Inputs tr earn is ; 
private OutputStream os; 
private int prog; 
private int vers; 



/** 

* Create a RPC session for the named server. 

* @param serverHostName The host name of a MSM server. 

* Oexception IQException If an error has occurred. 
*/ 

public MsmSession (String serverHostName) throws IGException 
this . serverHostName = serverHostName ; 
45 socket = new Socket (serverHostName, pmapGe tPort ! ) f ; 

is = new Buf f erecilnputSt ream ( socket . getlnputSt ream { ) i ; 
os = new 3uff eredOutputS t ream ( socket . getOutputStream ( ) } ; 

} 

so private int pmapGetPort { ) throws IQException { 
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PortMapper pmap = null; 
try { 

pmap = new PortMapper ( serverKcstName) ; 
int port; 
pzog = 100236; 
vers = 1; 

port = pmap. getPort (prog, vers, PortMapper . I PPROTO_TC?> 

if (port != 0) return port; 

prog = 0x206d736d; 

vers = Im- 
port = pmap . getPort (prog, vers, PortMapper . I PPROTO_TCP) 

if (port ! = 0) return port; 
} finally { 

if (pmap != null) pmap . close (} ; 
} ■ * 

throw new Msrr£xception("no msm server on 11 + serverHos tNarr.e } ; 

} 

/** 

* Closes a session with an MSM server. 

* gexcepticn MsraException If an error has occurred. 
*/ 

public void close (5 throws I ©Exception { 
socket .close ( ) ; 

} 

/** 

* All players on this server. 

* ^return an array of all players. 

* ^exception IOException If an errcr has occurred. 
*/ 

public MsmPiayer [ ] players () throws IOException { 
" XdrBiock reply = rpc (newCal 1 ( ?LAYER_LIS? ) ) ; 

Msm?Iayer[] result = new MsrcPlayer [ reply . xdrinlnt ()] ; 

for {int i = 0; i < result . length; i-+) { 
'result [i] = new MsmPiayer ( thi s , reply) ; 

reply . done ( ) ; 
return result; 



- Obtains status about titles. 

v Qparam titleName The name of the title on which to obtain 
status . 

* @return the status of the title. 

* ^exception IOException If an error has occurred. 
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V 

public MsmTitle getTitleStatus (String titleNarr.e) throws 
lOException { 

XdrBlock call = newCail (TITLE_GETSTATUS) ; 
call . xdrour String (titleName) ; 
XdrBlock reply = rpc(call); 

MsmTitle result = new MsmTitle ( reply) ; 
reply. done ( ) ; 
return result ; 

} 

/** 

* Returns the server host name. 
*/ 

public String getServerHos tName ( ) { 
return serverHostKame; 

} 

Xdr31ock newCail (int proci { 
return new XdrBlock (prog, vers, proc) ; 

} 

synchronized XdrBlock rpc (XdrBlock call) throws lOException-. 
call . send (os) ; 

XdrBlock reply - new XdrBlock ( is) ; 
try { 

reply . xdrinReplyHeader [ call . cai IX id { ) ) ; 
} catch (lOException e) { 

throw new MsmExcept ion (cai 1 . cailProc ( ) , e . gecMessace ( ) ) 

) 

int err = reply. xdr in Int ; ) ; 

if (err != 0) throw new MsmExcept ion (call . cailProc ( ) , err) ; 
return repl v; 

} 

public String toStringO { 
return MsmToS t r ing . sessionToSt 

} 

private static final int SERVER 
private static final int PLAYER 
private static final int PLAYER 
private static final int PLAYER 
private static final int PLAYER 
private static final int PLAYER 
private static final int PLAYER 
private static final int PLAYER 



rinq ( this : 



AUTHTYPE = 1 

"CREATE = 2 

"DELETE = 3 



SETACCES5 = 5 

"GETACCESS = 5 

~SE?PERS ISTENCE = 7 

"GETPERSISTENCE = 8 
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private 
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final 


int 


PLAYER_SETPLAYLIST 
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private 
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final 


int 


?LAYER_GET PLAYL I ST 
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final 


int 


PLAiER 5— ICONNLC- 
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private 
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final 


int 


PLAYER~GET CONNECT 
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private 


static 


final 


int 


PLAYER PLAY 
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private 


static 


final 


int 


PLAYER PAUSE 
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private 


static 


final 


int 


PLAYER RESUME 
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private 
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final 


int 


PLAYER GET PLAYS TAT US 




16 


private 


static 


final 


int 
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MsmAccessRight 



* @ (#) MsmAccessRight . j ava 
*• 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 
* 

* version 1 . 0 

* author Christopher Lindblad 



package COM. Sun. isg. smcjc; 

/** * 

* Access types, operations on access lists, and rights and 

* lists of access rights. 

+ Access types (read, admin, control) are the access catagories 

* defined by the MSM server (see MSM doc for each request to 

* determine the access catagory of that request). Access op r s 

* are the operations that can be made to alter access rights of 

* a particular user. An access right is the pairing of access 

* catagories with a particular user. An access list is a 
collection 

* of access rights for muitioie users. 
*/ 

public class MsmAccessRight [ 
public String name; 
public int access; 
public int op; 

public MsmAccessRight { String name, int access, int op} { 
this. name - name; 
this. access = access; 
this. op = op; 

I 

MsmAccessRight (XdrBlock xdr) [ 
name = xdr . xdr i nS c ring () ; 
access = xdr . xdrinlnt { ) ; 
op = xdr . xdr mint () ; 



void xdrout (XdrBlock xdr] 1 
xdr . xdr outSt ring (name } ; 
xdr . xdroutlnt (access) ; 
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} 



xdr . xdroutlnt (op) 



public String toStringf) ( 
return KsmToString. accessRightToString (this) 

} 



w 



public static final int ACCESS_ 

public static final int ACCESS^ 

public static final int ACCESS" 

public static final int ACCESS] 

public static final int ACCESS" 



NONE - 0; 
'ADMIN = i; 
READ - 2; 
CONTROL - 4, 
'ALL = 7; 



20 



25 



public static final int OP_ADD = 0; 
public static ^inal int OP REMOVE = 1; 
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MsrnPersistence 

/* 

* @ (#) MsrnPersistence . java 

* Copyright 1995 Sun Microsystems, Inc. Ail Rights Reserved. 

* version 1.0 

* author Christopher Lindblad 
* 

*/ 

package COM . Sun . isg . smc j c ; 
/** 

* MsrnPersistence information 
*/ 

public class MsrnPersistence { 
/** 

* Indicates the date at which the player should be 

* automatically deleted. On termmateDate, play if in 
progress, will 

* be stopped and the player deleted. A terminateDate of 
MSMTIME_MAXTIME 

* indicates the player should never be automatically 
deleted . 

*/ 

public long terminateDate; 
public int type; 

public MsrnPersistence ( int type, long terminateDate) { 
this. type = type; 

this . terminateDate = terminateDate; 

/ 

MsrnPersistence (XdrBlock xdr) { 
type = xdr . xdr inlnt ( ) ; 
terminateDate = xdr . xdr inMsmTime { ) ; 

} 

void xarout (XdrBlock xdr) { 
xdr . xdrout Int ( type i ; 
xdr . xdroutMsmTime ( terminateDate ) ; 

} 
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public String toStringO { 

" return MsmToString . persiscenceToString : this) ; 



/** 

* No persistence across server outage. 
*/ 

public static final int TY?£_N0NE = 0; 
/** 

* Only public static state is preserved/ play not is not 
restarted. 

*/ 

oublic static final int TYPE_PLAYL 1ST = 1; 
/** 

* Play is restarted after outage at last known playPosi t ion . 
*/ 

public static final int 7YPE_PLAYP0SITI0N = 2; 
/ * * 

* Play is restarted after outage as appropriate for current 

date . 

*/ 

public static final int TYPE_PLAYCURDATE = 3; 
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MsmPlaylist 

/* 

* @ {#) MsmPlaylist .lava 
+ 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 

* version 1 . 0 

* author Christopher Lindblad 

*/ 

package COM . Sun . i sg . smc j c ; 

* MsmPlaylist positions are measured in seconds and nanoseconds, 
titles on a 

* playlist nay be scheduled to start at any non-negative 
position. (In some 

* cases it may be convenient to base playlists positions at 0; 
in other 

* cases it may be better to base them with the OS representation 
of 

* time-of-day . ) The playlist maintains a contiguous sequence of 
titles and 

* "dead air". A schedule may be edited by replacing any 
contiguous 

* sub-sequence of the schedule with another sequence. It is 
also possible 

* to* change the starting position of the scheduled list of 
titles. Because 

* of mfs "admission delays", title start times may slip; msm 
opt ional ly 

* allows a title to be padded with dead air that can absorb the 
slip, or on 

* a slip the same title or a later title can be marked to be 
truncated or a 

* later title may be M joined-in-progress" to absorb the slip and 
maintain 

* schedule correspondence witn clock time. 
*/ 

public class MsmPlaylist ( 
/** 

* On Get, the current modification status stamp. On Put, 
modstamp on 

* which mods are based, if modification status has changed. 
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Mods are 

* aborted unless mcdstamp « MsmP layer . TIME_CURRENT , in 
which case mods 

* are always done. 
*/ 

public long mo ds tamp; 
/** 

* On Get, the starting playlist position for the returned 
playlist items 

* on Put, the playlist position where items are to be 
replaced . 

V 

public long editStartFosition; 

/** 

* On Get, the total duration of the items returned. on Put, 
the duration 

* of the existing playlist that is to be replaced with new 
i terns . 

* NOTE: On Put, edit range specified by editStartFosition 
for length 

* editDuraticn must lie entirely within existing playlist. 

Use 

* MsmPlayer . getPlaylist { ) to get lis tStartPosit ion and 
1 is tDuraticn to 

* determine playlist bounds. 
*/ 

public leng edi tDurat ion; 
/** 

* On Get, the startPosi t ion for trie entire playlist. On 
Put, the new 

* startPcsi tion for the playlist after edits. 

public long listStartPosi tion; 
/** 

* On Get, the duration of the entire list. On Put, ignored. 
*/ 

public long listDuration; 
pub lie MsmI tern [ ] 1 t em s ; 
/** 

* On Get, the current loop state of the playlist. On Put, 
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if TRUE, the 

* playiist wraps from end->start, start-end. 

*/" 

public boolean isLcop; 

public MsmPlaylist (long modstamp, boolean isLoop, long 
editStartPosition, 

long editDuration, Msmltemf] items, 
long listStartPcsit ion, long listDuration) 
this . modstamp = mod stamp ; 
this.isLoop = isLoop; 

this. editStartPosition = editStartPosition; 
this . editDuration = editDuration; 
this. items = items; 

this . listStarttPosi tion = 1 istStartPosi t ion; 
this . listDuration = listDuration; 

} 

MsmPlaylist (XdrBlock xdr) { 
modstamp = xdr . xdrinMsmTime ( ) ; 
isLoop = xdr . xdrinBoolean [ ) ; 
editStartPosition = xdr . xdr inMsmTime 1 ) ; 
editDuration = xdr . xdrinMsmTime ( ) ; 
items = new Msmltem [xdr . xdr mint ()] ; 
for (int i = 0; i < items . length; i++) { 
int itemType = xdr . xdrinlnt ( ) ; 
switch (itemType) 1 
case TITLE: 
items [i; » new MsmTitlelten (xcr : ; 
break; 
case DE ADAIR : 
itemsfi] = new MsmDeadAirl tern (xdr ) ; 
break; 

} 

} 

list Start Posit ion = xdr . xcr inMsmTime ; ■■ ; 
lie cDurat ion = xcr . xdr inMsmTime ( ) ; 



void xdrout (XdrBlock xdr) { 
xdr . xdrcutMsmTime (nods tamp) ; 
xdr . xdrout Boo lean ( isLoop) ; 
xdr . xdrcutMsmTime (editStartPosition) ; 
xdr . xdrcutMsmTime (editDuration) ; 
xdr . xdrout Int ( items . length) ; 
for (int 1 = 0; i < items . length; i + ^ ) { 
if (itemsli] instanceof MsmTit lei tern) 
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xdr .xdroutlnt (TITLE) ; 
( (MsmTi tie Item) items [i] ) . xdr out (xdr) 

} else { 
xdr . xdroutlnt (DEADAIR) ; 
( (MsmDeadAirltem) items [i] ) .xdrout (xd 

} 

) 

xdr . xdroutMsmTime (listStartPosition) ; 
xdr . xdroutMsmTime (listDuration) ; 

} 

public String toStringO { 

* return MsmToS tring . playlistToSt ring ( this ) 
} 

private static final int TITLE = 0 ; 
private static final int DE ADAIR = 1; 
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MsmConnect 

/* 

s + @ (#) MsmConnect . java 

+ 

* Copyright 1S95 Sun Microsystems, Inc. Ail Rights Reserved. 

* version 1.0 

io * author Christopher Lindblad 

•k 

*/ 

package COM . Sun . isg . smcj c; 
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/** 

* Connection paramaters. 

* These parameters are passed directly to of s_s tr_open { ) . 
*/ 

public class MsmConnect { 
/** 

* The transport independent address. 
**/ 

public String destTiAddr; 
/** 

* The packet encapsulation specifier (eg. MPEG Transport, * 
DSS, etc) . 

*/ 

public String encap; 
/ ** 

* The bits/second network bandwidth to request. 
V 

public int rate; 

public MsmConnect (String destTiAddr, String encap, int rate) 

f 

this .destTiAddr = destTiAddr; 
this. encap = encap; 
this. rate = rate; 

} 

MsxConnect !XdrBlcck xcr) ( 
destTiAddr = xdr . xdrinS t r mg ( } ; 
encap = xdr . xdr inS trine () ; 
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rate = xdr . xdr inlnt ( ) ; 

} 

void xdrou: (XdrBlcck xdr} { 
xdr . xdroutString (destTiAddr) ; 
xdr . xdr cuts tring (encap) ; 
xdr . xdroutlnt (rate) ; 

> 

public String toStringO { 
return MsmToS tring . connectToStr ing (this) 

} 
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MsmPlavStatus 



* 6 {#) MsmPlayStatus . java 
* 

* Copyright 1S95 Sun Microsystems/ Inc. All Rights Reserved. 
* 

* version 1 . 0 

* author Christopher Lindblad 



package COM . Sun . isg . smcjc; 

/ * * « 
+ MsmPlayS tatus indicates the current state of the player. 

* STATE_WAIT indicates that a play command has been given, but 

* that startDate has not arrived. 
V 

public class MsmPlayS tatus { 
public long pausePosi t ion; 
public long currentDate; 
public long currentPosit ion; 
public S tring info; 
public int currentState; 
public int currentSpeed; 
public boolean pausePendinc; 



MsmPlayStatus (XdrBlock xdr) { 
info = xdr . xdrinString ( ) ; 
pausePending = xdr . xdrinBoolean I } ; 
pausePosition - xdr.xdrinMsmTime ( ; ; 
currentState = xdr . xdrinlr.t { ) ; 
currentSpeed = xdr . xdr inlnt ( ) ; 
currentDate - xdr . xdrinMsrr.Time ( ) ; 
currentPcsition - xdr . xdrinKsmTime ( ;■ ; 

} 

public String toStringO { 
return MsmToSt ring . playStatusToSt ring ( thi s ) ; 



public static final int 5TATE_STO? = 0 

public static final int STATE_WAIT = 1 

public static final int S TAT £_ PLAY = 2 

} 
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MsmToString 

/* 

* @ ( # ) MsmToString . j ava 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 

* version 1 . 0 

* author Christopher Lindblad 



package COM. Sun. isg. smcjc; 

import java . util . * ^ 

class MsmToString { 

static String sessionToString (MsmSession se) { 
return "MsmSession" 

+ " [serverHostMame= n + se . getServerHostName ( ) 
+ " ] " ; 

} 

static String piayerToS tring (MsmPlayer pi) { 
byteU h = pi . getHandie ( ) ; 

StringBuffer sb = new S tringBuf fer (h . length* 2 ) ; 
for (int i = 0; i < h. length; { 
byte b = h [ i] ; 

sb. append (Character . forDigit ( (b >> 4) & Gxf, 15)); 
sb. append (Character. forDigit ( b & Oxf, 15)); 

} 

return "MsmPlayer" 

+ " [ serverHos tName=" + 
pi . get Session ( ) . getServerHostName ( ) 

+ 11 handle^" + sb . tcString ( ; 
+ " ] " ; 



private static final StringU rights = 
{ "admin", "read" , "control" ) ; 

private static final String! ] cos = { "add" , "remove" • ; 

static String accessRightToS tring (MsmAccessRight ari { 
StringBuffer sb = new S tringBuf fer (• ; 
for {int i = 0; i < rights . length; i + +) { 
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if ((ar. access & (1 << i)) != 0) { 
if (sb.lengthO > 0) sb . append ( " I" ) ; 
sb . append (rights [ i ]) ; 

} 

} 

if (sb.lengthO == 0) sb . append ( "none" ) ; 
String op; 

if (ar.op >= 0 ar.op < ops. length) op = ops [ar.op]; 
else op = String . valueOf (ar . op) ; 
return "MsmAccessRight " 
+ " [name= M + ar.name 

+ " access=" + sb . toString ( ) 
+ " op=" + op 
+ "]"; 

} 

static String connectToStr ing (MsmConnect co) ( 
return "MsmConnect" 

+ 11 [ des tTiAddr==\ " 11 + co . des tTiAddr + "\"" 
+ " encap=\ H " + co.encap + "\"" 

+ " race=" + co.rate 
+ " 3 " ; 



static String deadAir I temToStr ing (MsmDeadAir I tern dai) { 
return "MsmDeadAirl tem" 

+ " [itemDuration= M + dai . itemDurat ion 

+ " joinInDuration=" + dai . joinlnDuration 
+ »]"; 

} 

private static final String(] types = { 
"none" , "playiist" , "playposi t ion" , "playcurdat e" } ; 

static String persistenceToString (MsmPers is tence pe) { 
String type; 

if (pe.type >= 0 pe.type < types . length) type - 
types [pe . type] ; 

else type = String . valueOf (pe . type) ; 
return "MsmPers is tence" 
+ " [ type=" + type 
+ " 

terminateDate=\" "^dateToSt ring (pe . terminateDat e ) + "\ " " 
+ " ] " ; 

} 

static String dateToSt ring ( long date) { 
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if (date == MsmPlayer . TIME_MAXTIME) return "never"; 
else return new Date (date/ 1000000L) . toString () ; 

} 

private static final String [] states = 
{ "stop" , "wait", "play" } ; 

private static final String [] speeds = { 
"scene_reverse" , " f as test_reverse" , " f as ter_reverse" , "fast__rev 
erse" / 

••reverse", " slow^reverse" , "slower_reverse", "slowest_reverse"/ 
"slowest^forward"/ "slower_f orward" , " slow_f orward" , "forward" , 
" f as t_f orward" , " fas ter_f orward" , "fastest_forward" / "scene_f or 
ward" } ; 

it 

static String playS tatusToS t ring (MsmPlayS tatus ps) { 
String state; 

if (ps . currer.tState >= 0 && ps . cur rents tate < s tates . length ) 

{ 

state = states [ps . currentState ] ; 
} else state = String . valueOf (ps . cur rents tate ) ; 
String speed; 

if (ps . currentSpeed >= 0 && ps . currentSpeed < speeds . length) 

{ 

speed = speeds [ps . currentSpeed] ; 
} else speed = String . valueOf (ps . cur rentSpeed) ; 
return "MsmPlayStatus" 

+ " [info=\ n,t + ps.info +«\»» 

+ " pause?enaing=" + ps . pausePending 
+ " pausePosit ion=" + ps . pausePosi tion 
+ " currentState=" + state 
+ " currentSpeed=" + speed 

-r " currentDa te=\ " " - dateToString (ps . currentDate) + 
+ " current Position^" + ps . cur re nt Pes it ion 



static String playli stToSt r ing (MsmFlayli st pi) { 
StringBuffer sb = new S tr mgBuf f er { ) ; 
if (pi. items ! = null) { 

for (int i = C; i < pi . i terns . ieng z h ; i + { 
if (i '=0) sb. append "i ; 
sb . append (pi . items [ i ] . tc5:nng ( ) ) ; 

} 

return "MsmPlaylist" 
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+ " [modstarap=\ " " + dateToString (pi . modstamp) + 

- " isLoop=" + pl.isLoop 

- " editStartPosicion=" + pi . editSrarr Posit ion 
* " editDuration=" + pi . editTurat ion 

+ " ite^s=[" + sb. toString ( ) + j 

+ " listStartPosicion^" + pi . lists tar cPosit ion 

+ " listDuration=" + pi . 1 istDurat ion 

+ " 1 ; 



static String ti tleToString (MsmTi'le ti) ( 
StringBuffer sb = new StringBuf f er ( ) ; 
if { ti * speedScale ! = null) { 

for (int i = 0; i < ti . speedScale . length; i++) 
if <i ! = Jj } sb . append C , " ) ; 
sb - apoend ( ti . speedScale ( i j ) ; 

} 

} 

return "MsmTitle" 

+ M (narue=\ ,,M + ti.name + "\ ,,M 

+ " speedScale=[" + sb . toString ( ) + " ) " 

+ " maxBi tRa te=" + 1 1 . rnaxBi tRa te 

+ " totalPlayDuration=" + ti . totalPlayDuration 

+ " forn-at=\" " + ti.formac + M \ n " 

+ " ] " ; 

} 

static String titlel temToStr ing (MsmTi tiel tem ti) { 
return "MsmTi t lei tem M 

+ " [titieNa:ne=\"" + ti.titieName + "\"" 
+ " iteitDuration=" + ti . itemDurat ion 
+ ,f startOf fset=" + ti . startOf f set ■ 
+ " clayDuration=" + t i . clayDurat ion 
+ " joinlnDurat ion-" + ti . joinlr.Duration 
* " isTirieLocked=" ~ t i . i sTir.eLocked 
+ " piayClosestSpeed= n + ti .piayClosestSpeec 
+ " max3i tRate=" + ti .maxBitRate 
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Msmltem 

/* 

5 * @ {#) Msmltem. java 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 

* version 1 . 0 

10 

* author Christopher Lindblad 
★ 

*/ 

15 package COM . Sun . isg . smc j c ; 

oublic abstract class Msmltem { 

* The number of milliseconds allocated to this item. 
20 + / 

public long itemDurat ion; 
/** 

2s * Time of initial play that may be sacrificed to absorb 

previous schedule 

* slips. Silently limited to itemDurat ion . If 
TIME_CURRENT, 

* itemDuration is used. 

30 */ 

public long joinlnDuration; 

} 
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MsmTitteltem 

/* 

* @ (#)MsmTitieItem. java 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 

* version 1 . 0 

* author Christopher Lindblad 

*/ 

package COM . Sun . isg . smc jc; 
/* 

* A plavlist title item. 
*/ 

public class MsmTi tlel tern extends Msmltem { 
/** 

* The number of milliseconds intc title where play should 
begin. It is 

* illegal for this to be greater than the total play time of 
the title. 

public long startOffset; 
/** 

* The number of milliseconds of title to play within this 

item . 

* Values less than itemDuracion allow some pad fcr absorbing 
admission 

* delays (and the play truncation that would occur), but 
should admission 

* delay be zero, dead air would occur for the rexainder of 
Che item. It 

* -s illegal for playDuration to be greater than 
itemDura t ion or for 

* playDuraticn + startOffset :o be greater than the total 
play time of 

* the title. If T I ME_C U R REN T , the nin of itexDuration and 
total play time 

* minus startOffset is usee. 
V 

public long playDurat ion ; 
/** 
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* The file pathname for title. 
*/ 

public String titleName; 
/** 

* Ignored on Msm? layer .setPlaylist. Returns max bit rate c: 
title on 

* MsrnPlayer . getPlaylis t . 
*/ 

public int maxBi tRate ; 
/** 

* If true, terminate play after itemDuration seconds (ever, 
if admission 

* delays have ^caused schedule to slip and title has not 
completed) . I f 

* false, always play itemDuration seconds of title, allow 
schedule to 

* slip if necessary. 
*/ 

public boolean isTimeLocked; 
/** 

* If true, plays closest available speed in same direction 
i f requested 

* speed is not available. Search for closest is proceeds 
towards normal 

* presentation rate. Play is skipped if normal presentation 
rate in 

* direction is not available. If false, play of title is 
skipped if 

* aoprcpr iate soeec is not available. 
*/ 

public boolean playC loses t Speed ; 

public MsmTitlel tern {String titleName, long itemDuration, lone 
startOf "-set , 

long playDura t ion, long ioir.InDuration, 
boolean isTimeLocked, boolean piayCioses tSpeed, 
int rnaxBitRate) { 

this . titleName = titleName; 

this . itemDuration = itemDuration; 

this . startOff set = startOffset; 

this . piayDuration = playDuration; 

this . joinlnDura rion ~ jcinlnDuration; 

this . isTimeLocked = isTimeLocked; 

this.playCiosestSpeed = playClcsestSpeed; 
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this .raaxBitRate = maxBitRate; 



Msm?itleItem(XdrBlock xdr) { 
titleName = xcir . xdr mStr ing ( } ; 
iteniDuration = xdr . xdr inMsmTime ( ) ; 
startOffset = xdr . xdr inMsmTime {) ; 
piayDuration = xdr . xdrinMsmTime ( ) ; 
joinlnDuration = xdr . xdr inMsmTime ( ) ; 
isTimeLocked = xdr . xdrinBooiean () ; 
playClcsestSpeed = xdr . xdrinBooiean () ; 
maxBitRate = xdr . xdrinlnt ( ) ; 

} 

void xdrout (XdrBlock xdr) { 
xdr . xdroutString (titleName) ; 
xdr .xdroutMsmTirre ( i temDurat ion) ; 
xdr .xdroutMsmTime (startOffset) ; 
xdr . xdroutMsmTime (piayDuration) ; 
xdr . xdroutMsmTime (joinlnDuration) ; 
xdr . xdrourBoolean ( isTimeLocked) ; 
xdr .xdrounBoo lean (piayCios est Speed) ; 
xdr . xdroutlnt (maxBitRate) ; 

) 

public String toStringO [ 
return MsmToStr ing . tit lei temTcSt r ing ( this ! 

} 
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MsmDeadAirltem 
/* 

* @ ( #) MsmDeadAirltem. java 
* 

* Copyright: 1995 Sun Microsystems, Inc. All Rights Reserved. 
* 

* version 1.0 

* author Christopher Lindblad 

*/ 

package COM.Sun.isg. smcjc; 

public class MsmDeadAirltem extends Msmltem ( 

public MsmDeadAirltem ( long itemDuration, long j oinlnDuration) 

t 
\ 

this . i temDuration = i teaiDura t ion ; 
this . j oinlnDuration = j oinlnDuration; 

) 

MsmDeadAirltem (XdrBlock xdr) { 
itemDurat ion = xdr - xdrinMsmTime ( ) ; 
j oinlnDuration = xdr . xdrinMsmTime ( ) ; 

} 

void xdrout (XdrBlock xdr) { 
xdr . xdroutMsmTime ( itemDurat ion) ; 
xdr . xdroutMsmTime ( j oinlnDuration) ; 

} 

public String toString!) { 
return MsmToString . deadAir ItemTcStr ing ( this ) ; 

} 
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MsmException 

/* 

* S (#) MsmException . java 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 
-* 

* version 1 . 0 

* author Christopher Lindblad 
* 

*/ 

package COM. Sun. isg. smcjc; 

import java.io.*; * 

/** 

* Signals that an Media Stream Manager exception has occurred. 
*/ 

public class MsmException extends IOException { 
/** 

* Constructs an MsmException with no detail message. 

* A detail message is a String that describes this 
particular exceotion. *~ 

*/ 

MsmException { ) { 
super ( ) ; 

} 



/** 

* Constructs an MsmException with the specified detail 
message . 

* A. detail message is a Siring that describes this 
particular exception . 

* @param s the detail message 
V 

4Q MsmException (String s) { 

super ( s ) ; 

} 

MsmException ( int proc, String msg) { 
-*s super '( (proc >= 0 proc < procNames . length) ? 

procNanes [prcc ] : Integer . ccSt ring (proc j ) 

msg) ; 

} 

50 
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MsmException ( int proc, int err) { 
super ( ( (proc >= 0 && proc < procNames. length) ? 

procNames [proc] : Integer . toString (proc) ) 

((err >= 0 err < errNames . length ) ? 
errNames [err ] : Integer . toStnng (err ) ) ) ; 

} 

private static final String [] procNames = { 
"null", 

"server authtype" , 
"player create"/ 
"player delete" , 
"player list 1 * , 
"player access set", 
"player access get", 
"player persistence set", 
"player persistence get", 
"player playlist set", 
"player playlist get", 
"player connect set", 
"player connect get", 
"player play", 
"player pause", 
"player resuiue", 
"player play status", 
"title status", 
} ; 

private static final Stringf] errNames = { 



"success" , 


/* 


0 


*/ 


"failed", 


/* 


1 


*/ 


"badarg", 




2 


*/ 


"no mem", 


f + 


3 


*/ 


"no netname", 


/* 


A 


*/ 


"des auth failed", 


/* 


5 


*/ 


"kerb auth failed", 


/* 


6 


*/ 


"no such player", 


/* 


/ 


*/ 


"old mods tamp", 


/* 


8 


*/ 


"item overlap", 


/* 


9 


V 


"bad speed", 


/* 


10 


*/ 


"bad start date", 


/♦ 


1 2. 


V 


- not con nee ted " , 


/* 


12 


*/ 


"bad pause position", 


/* 


13 


*/ 


"play active", 


/* 


14 


*/ 


"bad file name", /* 


15 


*/ 




"bad mfs file", 


/ 


* 16 * 
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"bad 


file type", 


/* 


17 */ 




"info 


too long", 


/* 


18 */ 




"auth 


, failed", 


/* 


19 */ 




"bad 


position" , 




/* 20 


*/ 


" kerberos unsupported", 


/* 21 


*/ 


"bad 


credentials " , 


/* 


22 */ 




"insufficient authorization" , / 


* 23 


L)Ci.LX 


access op", 


/* 


24 * / 




HU a H 
UoU 


access type", 


/* 


25 */ 




"bad 


persist type", 


/* 


26 * / 




"bad 


time arg", 




/* 27 


*/ 


"bad 


start position 


1 1 

/ 


/* 28 


*/ 


"bad 


duration" , 




/* 29 


*/ 


"bad 


start offset", 


/* 


30 * / 




"bad 


edit stac-t pos 


ft 

/ 


/* 31 


*/ 


"bad 


edit duration" 


/ 


/* 32 


*/ 


"bad 


list start pos 


if 

/ 


/* 33 


*/ 


"bad 


item duration" 


/ 


/ * 34 


*/ 


"bad 


join in duration", 


/* 35 


*/ 


"bad 


play duration" 


/ 


/ * 36 


*/ 


"bad 


item type", 


/* 


37 * / 




"bad 


title type", 


/* 


38 * / 




"no such file", 




/* 39 


*/ 


"bad 


lut file", 




/* 40 


*/ 


"bad 


mfs fs", 


/* 


41 */ 




"toe 


syntax" , 


/* 


42 */ 




"toe 


eof ", 


/* 


43 */ 




"toe 


bad char", 




/* 44 


+ / 


"no normal speed", 


/* 


45 */ 




"dup 


speeds" , 


/* 


46 */ 




"bad 


file len", 




/* 47 


*/ 


"toe 


incomplete" , 


/* 


48 */ 




"toe 


can't map", 


/* 


49 */ 




"toe 


bad filesize", 


/* 


50 */ 




"toe 


bad index", 


/* 


51 */ 




"too 
} ; 


low connect rate", 


, /* 52 


*/ 
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XdrBlock 

/* 

* @ (#) XdrBlock. java 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 
▼ 

* version 1.0 

* author Christopher Lindblad 

*/ 

package COM . Sun . isg . smc j c ; 

import java.io.*; * 
import j ava .net.*; 

* Used to manipulate ONC RFC calls and replies. 
*/ 

class XdrBlock { 
byte [ ] buf; 
int ptr; 

/* 

* Create a new empty block. 

* gparam size The size of the block. 
*/ 

public XdrBlock (int size) { 
buf = new bytefsize]; 

} 

/* 

* Create a new empty block. 
*/ 

public XdrBlock () { 
this (256) ; 



/* 

* Create a new block and initialize it with a call header 

* @param prog The RPC program number . 

* 6 pa ram vers The RFC version number. 

* @param proc The RFC procedure number. 

* @ return The xid generated. 
*/ 
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public XdrBlock(int prog, int vers, int proc) { 
this () ; 

xdroutCallHeader (prog, vers, proc) ; 

} 

/** 

* Create a new block and receive it from an InputStream. 

* @paran is The InputStream from which to receive the bloc 

* Gexception IOException If an 10 error has occurred. 
V 

public XdrBlock ( InputStream is) throws IOException { 
synchronized (is) ( 
int hdr; 
do { 

hdr = readByte(is) << 24; 
hdr != reacByte(is) << 16; 
her |= reacByte(is) << S; 
hdr |= readByte(is) 
int start; 

int count = hdr & OxTfffffff; 
if (buf == null) ( 
start = 0; 

buf = new byte [count J; 
} else f 

start = buf. length; 

byte(] tmp = new byte[start + count]; 
System. arraycopy (buf , 0, tmp, 0, start); 
buf = tmp ; 

} 

while (count > 0) { 

int done - is.read(buf, start, count: ; 

if {done < C) throw new IOException i "end of file"' 

start + = done; 

count -= done; 

} 

} while l (hdr * 0x8DCC00DC; == C ; ; 

} 

1 

private int readByte ( Inputs trearr. is) throws lOExcepticn { 
int result = is,read(); 

if iresult < 0) throw new IOException ( "end of file M ); 
return result; 

) 

* Send the block to an output stream. 
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* @parara is The OutputStream ro which to send the block 

* @exception IOException If an 10 error has occurred. 
V 

public synchronized void send (OutputStream os) throws 
IOException { 

int hdr = ptr I 0x80000000; 
synchronized (cs) { 

os .write ( (hdr » 24) & Oxff); 
os .write ( (hdr >> 16) & Oxff); 
os .write ( (hdr >> 8) 6 Oxff ) ; 
os .write ( (hdr ) & Oxff ) ; 

os .write (buf, 0, ptr); 

if (os instanceof 3uff eredOutputStream) { 
( (Buff eredOutputStream) os) . flush () ; 

} 

} 

} 

/** 

* Input a fixed-length array of bytes from the block. 

* @param len The lenght of the array. 

* @ return The byte array. 
*/ 

public synchronized bytef] xcrinBytes ( int len; { 
bytef] result = new byteflen]; 
System . arraycopy !buf , ptr, result, 0, len) ; 
ptr=(ptr+len+3)&-4; 
return result; 

} 



* Input a variable-length array of bytes from the block 

* @return The byte array. 
V 

public synchronized byte [ 1 xdrin3ytes{) «. 
return xdr inBytes ( xcr in Int ( ) ) ; 

1 

/ * * 

* Input an int from the block. 

* G-return The ir.t. 
V 

public synchronized int xc::r;>t { ) { 
int: resul t ; 

result = (buffptr ] & Oxff) << 24; 

result 1= (buf [ptr + 11 & Oxff) << 15; 
result |= (buffptr + 2] & Oxff) << 3; 
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result |= (buftptr + 3] & Oxff) 

ptr += 4; 

return result; 

} 



* Input an boolean from the block. 

* greturn The boolean. 
*/ 

public boolean xdrinBoolean ( ) { 
return xdrinlnt() ! = 0; 



/** 

* Input a String from the block. 

* greturn The String. 
*/ 

public String xdr inStr ing ■; ; { 
return new String (xdrinBytes {) / 0) ; 

) 

/ + + 

* Input a Media Stream Manaoer Time value 
*/ 

public synchronized long xdrinMsmTinte ( ) { 
long sec = xdrinlntO; 
long nsec = xdrinlntO; 

if (sec == nsec sec < 0) return sec; 
return sec* LOOGOOOOOOL + nsec; 

} 

/** 

* Output a fixed-length array of bytes to the clock. 

* Qparara vai The array to output. 

* frparam len The length of the array to output. 
V 

40 public synchronized void xdroutBytes (byte [ ] val, int len) 

int nxt - (ptr + len + 3} & -4; 
if (nxt > buf. length) grcw(nxt); 
System. arraycopy ( vai , 0, buf, ptr, len) ; 
otr = r.xt; 



/** 

* Output a variable-length array of bytes to the block, 

* gparam val The array tc outout. 
V 
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public synchronized void xdroutBytes (byte [ ] val) { 
int len = val. length; 
xdroutlnt < len) ; 
xdroutBytes {val, len) ; 

} 

/** 

* Output an int to the block. 

* @param val The int to output. 
*/ 

public synchronized void xdroutlnt ( int val) { 
int nxt = ptr + 4; 
if (nxt > buf. length) grow (nxt) ; 
buf [ptr ] = (byte) {(val » 24) & Oxff); 
buf [ptr + 1] =- (byte) ( (val >> 16) & Oxf f ) ; 
buf [ptr + 2] = (byte) ( (val >> 8) & Oxff); 
buf [ptr + 3] = (byte) ( (val ) & Oxff); 

ptr = nxt; 

} 

/** 

* Output an boolean to the block. 

* @param val The boolean to output. 
V 

public void xdroutBoolean (boolean val) { 
xdroutlnt (val? 1:0); 

} 

/** 

* Output a String to the block. 

* Q pa ram val The String to output. 
*/ 

public void xdroutString (String val) { 
int len = val . length () ; 
byte [ ] tmp = new byte [len]; 
val . TatBytes (0, len, tmp, 0); 
xdroutBytes (tmp) ; 

} 

/* * 

* Output a Media Stream Manager Time value 

* £ pa ram val The time to output. 

public synchronized void xdroutMsmTime ( long vai) { 
if (val < 0) { 

xdroutlnt { ( int ) vai ) ; 
xdroutlnt ( ( int ) vai ) ; 
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to 



} else { 

xdroutlnt ( (int) (val/lOOOOOOOOOL) ) ; 
xdroutlnt ( (int) ( val%1000000000L) ) ; 

} 

) 

private void grow (int needed) { 
int len = buf , length*2; 
while (len < needed) len **= 2; 
by te [ ] tmp = new byte [len]; 

System, arraycopy (but, 0, tmp, 0, buf. length); 
buf = tmp; 

> 

/** 

* Output a RPC Call header to the block. 

* <?param prog The RPC program number. 
20 * gparam vers The RPC version number. 

* @param proc The RPC procedure number. 
V 

public synchronized void xdroutCailHeader ( in: prog, int vers, 
int proc) { 

xdrout Int (genXid { ) ) ; 
xdroutlnt (CALL) ; 
xdroutlnt (RPCVERS) ; 
xdroutlnt (prog) ; 
xdroutlnt (vers) ; 
xdroutlnt (proc) ; 
xdroutlnt (AUTHJJNIX) ; 
xdrout Bytes { cred { ) ) ; 
xdroutlnt (AUTH_NULL) ; 
xdroutBytes ( verf ( ) ) ; 

i 

public synchronized int caliXidO { 
int tmp = prr; 
ptr = b; 

int result ~ xdrinlntO; 
ptr = tmp; 
return result; 
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public synchronized int cailProc 0 
int tmp = ptr; 
ptr = 20; 

int result = xdrinlntO; 
ptr = tmp ; 
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return result; 

} 

private static int lastXid = 0; 

private synchronized static int genXid() ( 
if (lastXid != 0) lastXid ^= 1; 

else lastXid = ( int ; (Math . random ( ) * 2147483648 . 0D) ; 
return lastXid; 

} 

private static byte[] lastCred; 

private synchronized static byte [ ] credo { 
if (lastCred ~r null) { 

XdrElock xdr = new XdrBlock(); 

xdr . xdrouclnt ( (int) (System. current TimeMi His 0 /1000L) ) 
String host; 

try host = InetAddress - getLocalHos t ( ) . getHos tName ( ) ; 
catch (UnknownHos tExcepnion e) host = ,f ??? M ; 
xdr . xdroutString (host ) ; 
int uid; 
try uid = 

Integer . parse Int (System. get Property (" user . uid" ) ) ; 

catch (NumberFormatException e) uid = 0; 
xdr . xdroutlnt (uid) ; 
int gid; 
try gid = 

Integer .parse Int (System. get Property ( "user . gid" ) ) ; 

catch (Number Forma t Except ion e] gid = 0; 
xdr . xdroutlnt (gid) ; 
xdr . xdroutlnt ( 0) ; // no gids 

lastCred = new byte [xdr . ptr ] ; 

System. arraycopy (xdr . bur, 0, iastCrec, 0, xdr. ptr); 

} 

return lastCred ; 

} 

private static byte ! J lastVerf; 

private synchronized static byte[] ver: () ( 
if (lastVerf == null) { 

lastVerf = new byte[0]; 

} 

return las tVe r f ; 

i 
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/** 

* Input a RPC reply header frcn the block. 

* @param xid The expected xid. 

5 * {^exception IOException If an error has occurred. 

*/ 

public synchronized void xdrinP.eplyHeader { int xid; throws 
IOException { 

int replyXid = xdrinlntO; 
10 if (replyXid 1= xid) { 

throw new IOException ( 
" rpc xid mismatch: " + 

"expected " + xid + " but got n + replyXid) ; 

} 

is int msgType - xdrinlntO; 

if (msgType .! = REPLY) { 

throw new IOException ( 
"rpc msg type mismatch: " + 

M expected " + REPLY + " but got " * msgType) ; 

20 ) 

int replyStat = xdrinlntO; 
switch (replyStat) { 
case MSG_ACCEPTED: 

int verfType = xdrinlntO; 
25 byte [J verf = xdr inBytes ( ) ; 

int acceptStat = xdrinlntO; 
switch (acceptStat) { 
case SUCCESS: 
return; 
case PROGJJNAVAI L : 
throw new IOException ( 
"rpc accepted: " + 

"remote hasn't exported program"); 
case ?ROG_MISMATCH: 
int low = xdrinlntO; 
int high = xdrinlntO; 
throw new IOException ( 
"rpc accepted: " + 

"version mismatch low=" + low +■ " high=" + high) 
case ?ROC_UNAVAIL: 
throw new IOException ( 
"rpc accepted: " + 

"program can't supper t procedure") ; 
45 case GAR3AGE_ARGS : 

throw new IOException ( 
"rpc accepted: M + 
"procedure can't decode params"); 
default : 

50 
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throw new IOException < 
"rpc accepted: " + 
"unknown status: " + accepts tat ) ; 

} 

case MSG_DENIED: 

int rejectStat = xdrinlntO; 
switch (rejectStat) ( 
case RPC_MISMATCH: 
int low = xdrinlntO; 
int high = xdrinlntO; 
throw new IOException ( 
"rpc rejected: " + 

"version mismatch low=" + low + " high 
case AUTH_ERROR: 
int authStat = xdrinlntO; 
switch (authStat ) { 
case AUTH_BADCRED: 

throw new IOException ( 
"rpc rejected: " + 

"remote can't authenticate caller: " 
"bad credentials (seal broken}"); 
case AUTH_REJECTEDCRED: 

throw new IOException) 
"rpc rejected: " + 

"remote can't authenticate caller : " 
"client must begin new session") ; 
case AUTH_3ADVERF: 

throw new IOException ( 
"rpc rejected: " +■ 

"remote can' t authenticate caller : " 
"bad verifier (seal broker.)"); 
case AUTH_REJECTEDVERF: 

throw new IOException ( 
"rpc rejected: " + 

"remote can' t authenticate caller: " 
"verifier expired or replayed") ; 
case AUTH_TOOWEAK: 

throw new IOException ( 
"rpc rejected: " + 

"remote can * t authenticate caller : " 
"rejected for security reasons") ; 
default : 

throw new TOExcept ion ' 
"rpc rejected: " + 

" remote can ' t authenticate taller: " 
"unknown status: " + authStat) ; 

} 
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default : 
throw new IOExcepi ion < 
"rpe rejectee: " + 
"unknown status: " + rejectStat) ; 

} 

default: 

throw new IOExcept ion { "unknown rpc reply status: 11 + 
replyStat ) ; 
] 

} 

/* 

* 3low up if ptr hasn't reached the end of the block. 
*/ 

public void donje { ) throws lOException { 
if (ptr buf. length) { 

throw new lOException { 
(buf , length-ptr ) + " extra bytes of ca:a remaining in 

reply") ; 
} 

) 

/* 

* Provisions for authentication of caller to service and 
vice-versa are 

* provided as a part of the RPC protocol. The call message 
has twe 

* authentication fields, the credentials and verifier. The 

reply 

* message has one authentication field, the response 
verifier. The RPC 

* protocol specification defines all three fields to be the 
f o 1 lowing 

* opaque type 
language [ 9] ) : 

*/ 

private static 
private static 
private static 
private static 

/' 

* RPC Message 

* / 

private static 
private static 
private static 



(in the external Data 



final int AUTH__NULL 

final int AUTHJCNIX 

final ir.t AUTH_SHORT 

final int AUTH DES 



protocol version 2 

final int RPC VERS = 2; 
final int CALL = 0 ; 
final mt REPLY = 1 ; 



? ep resent a t icn ■ XDR) 

= 0; 
-> . 
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/* 

* A replv to a call message can take on two forms: The 
message was 

* either accepted or rejectee . 

* / 

private static final int MSG_ACCEPTED = 0; 

private static final int MSG_DENIED = 1; 

/* 

* Given that a call message was accepted, the following is 
status 

* of an attempt to call a remote procedure. 
*/ 

private static final int SUCCESS = 0; 

private static *final int PROGJJNAVAIL = 1; 

private static final int PROG_MISMATCH = 2; 

private static final int PROCJJNAVAIL = 3; 

private static final int GARBAGE_ARGS = 4; 



* Reasons why a call message was rejected: 
*/ 

private static final int R?C_MISMATCH = 0; 

private staric final int AUTH_ERROR « 1; 

/* 

* Whv authentication failed: 
*/ 

private static final int AUTH_B ADC RE D 

private static final int AUTK_RE JECTEDCRED 

orivate static final int AUTH_BADVERF 

private static final int AUTH_RE JECTEDVERF 

private siatic final int AUTH_TOOWEAK 

35 

) 
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PortMapper 

/* 

* @ (#) PortMapper . java 
* 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 

* version 1 . 0 

* author Christopher Lindblad 

* 

*/ 



package COM . Sun . isg . smcjc; 

import java.io.*; ^ 
import java .net . * ; 

/** 

* Interface to the ONC ocrt maooer. 
*/ 

class PortMapper { 

private Socket socket ; 
private Inputs t ream is ; 
private Outputs tream cs; 

/** 

* Create a port mapper client. 

* <?param host The server for which we want tc know the pore 
mappings . 

* ^exception IOException If there is an errcr. 
V 

public PortMapper (String host) throws IOException { 
socket "= new Socket (host, ?MAP_P0RT » ; 

is ~ new Buf f e red Inputs tream (socket . get Inputs tream ( ) ) ; 
cs = new Buf f eredOutputSt ream (socket . get OutputSt ream ( ) ) ; 

i 
; 



/** 

* Get the pert number for a particular ONC service. 

* Sparam prcg The R?C program number. 

* (?param vers The RFC version number. 

* ?param prot Either IPPROTCJTCP or 1PPR0TC JJD? . 

* @ return The port number for the service. 

* ^exception IOException If there is an error. 

* / 

public synchronized int get ?ort ( ir. t prog, ir.r vers, int prot) 
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throws IOException { 

XdrBlock call = new XdrBlock () ; 
call .xdroutCallHeader <PMAP_PROG, 
PMAPPROC GETPORT); 



PMA? VERS, 
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call . xdroutlnt (prog) ; 
call . xdrcut Int (vers ) ; 
call . xdroutlnt (pro t ) ; 
call .xdrcutlnt (0) ; 
call . send (os) ; 

XdrBlock reply = new XdrBlock ( is ) ; 
reply . xcrinReplyHeader (call - callXid () ) ; 
int result = reply . xdrinlnt (> ; 
reply .dene { ) ; 
return result; 
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* Closes the port mapper. 
*/ " 

public synchronized void closet) :hrows IOException { 
socket . close ( ) ; 

} 

static final int IPPROTOJTCP = 6; 
static final :nt IPPROTOJJDP = 17; 

private static final int ?MAP_PROG = 100000; 
private static final int ?MAP_VZRS = 2; 
private static final int PMAP PORT = 111; 



orivate static final int ?MAP?ROC_NULL = 0 

orivate static final int ?MAP?ROC_SET = 1 

orivate static final int PMAPPROC JJNSIT = 2 

orivate static final int ?MA??ROC_GET?ORT = 3 

orivate static final int ?MA??ROC_DUMP = 4 

orivate static final int PMAPPROC CALL IT - 5 
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Decoder 

/* 

* @ (#) Decoder . java 



* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 



* version 1-0 

* author Christopher Lindblad 



*/ 



package COM . Sun . isg . smcjc; 

import java.awt.*; * 
import java . io. * ; 

public class Decoder extends Panel I 
private Decoder Imp! impi; 

public Decoder!) { 
setLayout (new BorderLaycut ( ) ) ; 

} 

Public synchronized void init (String format, Image img, String 
host,int pore, String ATM) 
throws ICException ( 

t ClaL implClass = Class . fforNa.ne ( impIClassName ( format )} ; 
A (LpT P « null 11 impl.getClassO - implClass) { 
removeAll'J; 

impl = (Decoderlmpl) implClass. newlnstance {, , 
add ( "Center" / imp!) ; 

impl- -nit (format, img, host, port, ATM) ; 
} catch (ClassNotFoundException e) I 
throw new ICExcept ion (e . toStnnc ( ) ) ; 
"} catch (illegalAccessExceptior. e) { 
throw new IGExcept ion (e . toStr in g ( j ; ; 
) catch (instantiationException e) { 
throw new lOExcept ion (e . toSrr i" g ( ) 1 ; 

) 

\ 

public synchronized void paint (Graphics q) i 
if (imol ! = null'.' super . paint (g) ; 
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else { 

Rectangle b = bounds!); 

g . set Co lor (get Background ( ) ) ; 

g. fill3DRect (0, 0, b. width, b. height, true); 

} 

} 

public synchronized void stopO throws lOExcepticn { 
if (inol !- null) impl . stop 0 ; 

> 

public synchronized void pause () throws IOException { 
if (impl != null) impl .pause 0 ; 

) 

public synchronized void playO throws IOException { 
if (impl != null) impl.playO; 



public synchronized void flush () throws IOException { 
if (impl != null) imp! . flush () ; 

25 

public synchronized String cestTiAddrO throws IOException { 
if (impl != null) return iir.pl . destTiAddr { ) ; 
return 

30 

public synchronized String encapO throws IOException ( 
if (impl != null) return impl . encap ( ) ; 
return ; 

35 

/ * * 

* A hacky implementation factory 
*/ ~ 

40 private static String implCiassName ( S t ring format) throws 

IOException { 

String osArch = System . getProperty { "os . arch" , " ?os . arch" ) ; 
String osName = System . getProperty ( "os . name" , " ?os . name" ) ; 
String os Vers ion - System. getProperty ( "os . version" , 
4 s "?os .version") ; 

String spec = format + " " + osArch + " " + osName + " " + 
osVersion ; 

if ( format. equals ("MPEG1SYS") ) { 

if (osName . equals ( "Solaris" ) ! I osName . equals ( "SunOS" ) ) 

50 ^ 
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if (osArch . equals ( "spare" ) ) { 

return "COM . Sun . isg . siuc jc .MpxDecoder Impl " ; 

} 

) 

i 
; 

throw new IOExcept ion ( "no decoder for " + spec); 

} 



Decoderlmpl 

/* 

* @ (#) Decoder Impl . java 
* 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 
+ 

* version 1 . 0 

* author Christopher Lindblad 

*/ 

package COM. Sun. isg. smeje; 

impo r t j a va , awt. . * ; * 
import java.io.*; 

abstract class Decoder Impl extends Canvas { 

public abstract void init (String format, Image img, String 
host, int port, String ATM) throws IOException; 

public abstract void stop ( } throws IOException; 

public abstract void pause () throws IOException; 

public abstract void play (5 throws IOException; 

public abstract void f lush ( ) throws IOException; 

public abstract String destTiAddr{) throws IOException; 

oublic abstract String encap ( ) throws IOException; 

} 
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MpxPecoderlmpl 

/* 

* @ ( # ) Mpx Decoder Impl .]ava 

* Copyright 1995 Sun Microsystems, Inc. Ail Rights Reserved. 

* version 1 . 0 

* author Christopher Lindblad 



30 



*/ 

is package COM . Sun . isg . smc j c ; 

import java . applet ; 

import java.io.*; 

import j ava . awt . * ; 

20 import java.net.*; 

class MpxDecoder Impl extends Decoderlmpl implements Runnable { 
private String format; 
private String host; 
25 private int port; 

private int portO; 
private Image img; 
private long f adeTimeMiiiis; 
private DatagramSocket ctrlSckt; 
private Thread thread; 
private DatagramPacket ctr lPckt ; 
private File logFile; 
private float luminance = l.GF; 
private int dataPort; 
private int scale = 1; 
private int state=STOP; 
private boolean nuiti=f alse; 
private boolean ATM=false; 
private String ATMs=null; 

public MpxDecoder Impl ( ) { 
super ( ) ; 

} 

public synchronized void init (Siring rcrnat, Image img, 
St r i nc host , int por t , String ATMs ) 
throws ZOExcept ion { 

this. format = format ; 
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this.img = img; 
ATM= (ATMs !=null{ ; 

this . port=pcrt ; 

this . hos t=hos t ; 

if ( (port==-I) ( : ATM) ) { 
dataPort = genLocaiPort () ; 

}else{ 

dataPort = port; 
port0= genLocaiPort () ; 
multi= ! ATM; 

if (ATM) this . ATMs - ATMs; 

} 

ctrlPckt = new DatagramPacket ( 
new 

byte [128] , 128 , Inet^ddress . getLocalHos t ( ) , genLocaiPort ( ) ) ; 



ctrlWord (0, 
ctrlWord (1, 
ctrlWord (2, 
ctrlWord (3, 
ctrlWord (4, 
ctrlWord (5, 
ctrlWord (6, 
ctrlWord (7, 
ctrlWord (8, 



CxOOOOOCOl); // 
CxOOOOOC-02) ; // 
Cx00000C03); // 
CxD00O0C04); // 
CxaaaaOOOl); // 
CxbbbbOCOl) ; // 
OxOOOOOCOO); // 
OxccccOOOO) , 
OxddddOOOl) , 



sync 
sync 
sync 
sync 

version = 1 
channel = 1 
sequence = 0 
// flags - 0 
// type = 1 



public Dimension minimumSize ( ) {' 
30 return new Dimension (WIDTH, HEIGHT); 

} 

public synchronized Dimension pref erredSize ( ) { 
Dimension dim = new Dimension (WIDTH* sea le , HEIGHT* scale ) 
35 return dim; 



public synchronized void layout () { 
Rectangle b - bounds!); 

double xscale = (double) b . width/ (double ) WIDTH ; 
double yscale - (double) b . height/ {double) HEIGHT ; 
int scale = (int) ( (xscale + yscale! / 2.0 + G.25); 
if (scale < 1J scale = 1; 
if (scale > 3; scale = 3; 
if (scale != this. scale) ( 
this. scale = scale; 

if (state == PAUSE ! I state ~ FLAY ) updateVideoMode 

} 
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public synchronized void paint (Graphics g) { 
Dimension ps = pref erredSize ( ) ; 
g . setCoior (ge tBackground ( ) ) ; 

g. f iI13DRect (0, 0, ps. width, ps. height, true); 
if (img != null) g . drawlmage ( img, 0, 0, ps. width, ps. height, 
this) ; 
} 

w 

public synchronized void stopO throws IOException { 
if (state « PAUSE I I state == PLAY) [ 

if (multi I I ATM) { 
/5 StringBuffer sc= new StringBuf f er ( ) ; 

sc . append { " kloop ") ; 
System. out .print In (sc. toString ( ) ) ; 

String [] cmdarray0= new string ( 3] ; 
cmdarrayO [0] = Vbin/sh" ; 
20 cmdarrayO [1] = "-c"; 

cmdarrayO [2] = sc . toString () ; 
try Runtime . getRuntime ( ) . exec (cmdarrayO) ; 
catch (SecurityException e) 
System. out . Drintln ("£xec=" + exec (cmdarrayO [2] ) ) ; 

25 ' J 

ctrlWordO, MCMD_EX IT ) ; 

ctrlSckt . send (ctrlPckt ) ; 
ctrlSckt • close ( ! ; 
ctrlScict = null; 
state = STOP; 
try { 

if (logFile . length ( ) == 0) logFile . delete () ; 
} catch (SecurityException e) { 
String cmd = "/bin/rm -f " + logFile . ge tPath ( ) ; 
try Runtime . getRuntime ( ) .exec (cmd) ; 
catch (SecurityException f; exec (cmd); 
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} 

} 

public synchronized void pause ( ) throws IOException { 
if (state PLAY ) ( 

ctrlWordO, MCMD_PLAYCTR) ; // identifier 

ctrlWorddO, PC_?AUSE) ; // action 

ctrlWord ( 11 , Float . float To IntBits ( i . OF) ) ; // speed 
ctrlSckt - send {ctrlPckt ) ; 
state = PAUSE; 

} 
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public synchronized void playO throws IOException { 
* if (state PAUSE) { 

ctriWordO, MCMD — PLAYCTR) ; // identifier 

ctriWord(10, PC_PLAY) ; // action 
ctrlWorddi, Floa. . f loatToIntBi ts ( 1 . CF) ) ; // speed 
ctriSckt -send {ccr lPckt) ; 
w state = PLAY; 

} else if (state == STOP) { 

StringBuffer sb = new StringBuf f er ( ) ; 
sb. append { "exec mpx" ); 
if (Imulti) { 
75 if ( ! ATM ) { 

stv append ( " -fn udp,lp," ); 
sb . append (da taPort ) ; 
} else { 

sb. append (" -fn ucp, ip, " ); 
20 sb . append {port 0) ; 

} 

}else{ 

sb . append ( " -f n . udp, ip, " ) ; 
sb . aooend (port 0) ; 

25 , 

sb. append (" -xn udp, lp, " ); 
sb.appendfctrlPckt . getPcrt {) ) ; 
sb. append ( -u 2" J ; 
sb. append ( '* -v " ) ; 
30 int depth = getColcrModei { ) . get PixelSi ze ( ) ; 

if (depth == 1) { 

sb . append ( "mono" ) ; 
} else { 

sb . append ( "col " ) / 

sb . append (depth) ; 

if (depth == 24 scale > 1) sb . append { "3" ) ; 

} 

sb . append (","); 
40 sb. append (scale) ; 

sb. append (" ") ; 

sb . append (windcwld ( ) ) ; 

sb. append (" </dev/nuii M ) ; 

sb . append { ,% >" ) ; 
45 System . cut . print in ( sb . toSt ring ! ; ) ; 

logFile = new 
File ( " / tmp/mpx . " ^System. cjrrentTimeMil lis ( ) ) ; 

sb. append ( logFile . getF a th ( ) ) ; 

sb. append ( " 2>&i M ) ; 



83 



EP 0 803 826 A2 



Stringf] cmdarray = new String[3]; 
cmdarray [0] = "/bin/sh"; 
cmdarrayfl] - "-c"; 
cmdarray[2] = sb. toString ( ) ; 
try Runtime . getRuntime ( ) . exec (cmdarray ) ; 
catch (Secur ityException e) exec (cmdarray [ 2 ]) ; 
ctrlSckt = new Da tagramSocke t ( ) ; 
state = PLAY; 
if (ATM) { 

StringBuffer sc= new S tringBuf fer () ; 
sc. append ("loop a " ); 
sc . append (dataPort+" " ) ; 
sc . append (pcrtO*" >sasa &"); 
System, out . print In (sc . toString ( ) ) ; 

String[]. cmdarrayO= new String[3J; 
cmdarrayO [0] = "/bin/sh" ; 
cmdarrayO[l] = "-c"; 
cmdarrayO [2] = sc . toString () ; 
try Runt ime . getRuntime ( ) . exec (cmdarrayO) ; 
catch (SecurityException e) 
System, out .print In ("Exec= ,1 + exec (cmdarrayO [2] ) ) ; 
}else if (multi) { 

StringBuffer sc= new S tringBuf fer () ; 
sc. append ("loop m "); 
sc . append (host+" ") ; 
sc. append (da taPort+" ) ; 
sc . append (port 0+" &") ; 
System. out.println(sc.toString() ) ; 

String [] cmdarrayO- new String [3]; 
cmdarrayO(0] = "/bin/sh"; 
cmdarrayO [1] = "-c"; 
cmdarray0[2] = sc . toString {) ; 
try Runtime . getRuntime ( ) . exec ( cmdarrayO) ; 
catch (SecurityException e) 
System. out .print In ( "£xec=" + exec (cmdarrayO [ 2 ) ) ) ; 
} 

} 

} 

public synchronized void flush () { 
if (thread == null) [ 

thread = new Thread ( this ) ; 
thread .start ( ) ; 

> 

f adeTineMillis = Sys.em . currentTimeMi 1 lis ( ) - 4000 

} 
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public synchronized String destTiAddr ( ) throws 
UnknownHostException ( 
String phost; 
//return "beO, "+phost+", "+dataPort; 
if (ATM) { 

return "port=" + ATMs + ^vc= ,, + dataPort; 
}else { 

phost = InetAddress . getLocalHost ( ) . getHostName ( ) ; 
return ,, host= n + phost + ",udpport=" + dataPort; 

} 

} 



is 



20 



25 



public String encapO { 
return "MPEG1SYS"; 

private void ctrlWord(int idx, int val) { 
byte[] buf = ctrlPckt . getData ( ) ; 

bu£[idx*4 ] = (byte) ((val >> 24) & Cxf f ) ; 

buf[idx*4 + 1) » (byte) ( (val » 16) & Oxf f ) ; 

buf[idx*4 + 2) = (byte) ({val » 8) & Cxf f ) ; 

buf[idx*4 + 3] = (byte) ( (val ) & Oxf f ) ; 

) 



30 



35 



40 



private void updateVideoMode ( ) { 
ctrlWord(9, MCMD_PRESCTR) ; // identifier 
ctrlWordQO, PCTRJ/MD | PCTR_LUM) ; // which 
int depth = getColorModel ( ) . getPixelSi ze ( ) ; 
int col = (depth==D? 0 : (depth==24&&scaie>l ) 
VDM_COL; 

(col<<8) ; scale); // video mode 
0;; // audio mode 

0} ; // audio_voluine 

Float. f loatToIntBits (luminance) ) ; 
0; ; // saturation 

0] ; // gamma 

. send (ctrlPckt ) ; catch (IOException 



ctrlWord (11, 
ctrlWord (12, 
ctrlWord(13, 
ctrlWord(14, 
ctrlWordQS, 
ctrlWord(16, 
try ctrlSckt 



? VDM COLB 



// luminance 



e) 



so 



public synchronized void run!) { 
Thread currentThread = Thread . currentThread () ; 
try [ 

while (cur rent Thread== thread { s ta te==PAUSZ I I 

state==PLAY) ) { 

long currentTimeMillis = System. currentTimeMillis ( ) ; 
float last = luminance; 

if ( f adeTimeMillis < currentTimeMillis) { 



55 
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if (luminance < 1.0F) luminance += 0.125F; 
} else { 

if (luminance > 0.0F) luminance -= 0.125F; 

} 

if (luminance != last) updateVideoMode ( ) ; 
if (luminance >= 1.0F) return; 

try wait (125); catch ( Inter ruptedExcept ion e) ; 

} 

} finally { 

if (thread == currentThread) thread = null; 

> 

} 

private int genLocalPort ( ) throws IOException ( 
DatagramSocket sckt = new DatagramSocket () ; 
int port - sckt . getLocalPort ( ) ; 
sckt . close ( ) ; 
return port; 

} 

private native int windowIdO; 

private native int exec (String cmd) ; 

protected void finalize () { 
try stopO; catch (IOException e) ; 

} 

private static final int WIDTH = 352; 
private static final int HEIGHT = 240; 

private static final int STOP = 0; 
private static final int PLAY = 1; 
private static final int PAUSE = 2; 



/* command identifiers */ 

private static final int MCMD_NULL = 0; 

private static final int MCMD_EXIT = I; 

private static final int MCMD_OPENSRC = 2; 

private static final int MCMD_CLOSESRC = 3; 

private static final int MCMD_RE ENTER = 4; 

private static final int KCMD_PLAYCTR = 5; 

private static final int MCMD_?RESCTR = 6; 

private static final int MCMD_STREAM = 7; 

private static final int MCMD_SENDSTAT = 8; 

private static final int MCMD_STATUS = 9; 

private static final int MCMD ACK = 10; 
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/* command flags */ 



private 


static 


final 


int 


MCFL SNDACK 




(1«0) 


private 


static 


final 


int 


MCFL_ORGMPX 




(1<<2) 


/ * command parameter 


values: */ 






/* source type 




MCMD OPENSRC */ 






private 


static 


final 


int 


MSC FNAME 


- 


1; 


private 


static 


final 


int 


MSC_FDSCP 




4 ; 


/* flags : 


MCMD_ 


REENTER */ 






private 


static 


final 


int 


MRE FOFS 




(1«0) 


private 


static 


final 


int 


MRE ASOPEN 


= 


(1«2) 


private 


static *f inal 


int 


MRE STRMS 




( 1«3) 


private 


static 


final 


int 


MRE SEEKVSEQ 





(1«4) 


/* data_ 


type 




MCMD OPENSRC, MCMD 


_RE 


ENTER * 


private 


static 


final 


int 


BSTRM 11172 




( 1«0) 


private 


static 


final 


int 


BSTRM VSEQ 




(1«1) 


private 


static 


final 


int 


' BSTRM ASEQ 




(1«2) 


/* action 




MCMD PLAYCTR +/ 






private 


static 


final 


int 


PC PLAY 


— 


( l«0) 


private 


static 


final 


int 


PC FWDSPEED 


= 


( 1<<1 ) 


private 


static 


final 


int 


PC FWDSTEP 




( 1<<2 ) 


private 


static 


final 


int 


PC PAUSE 


_ 


(1«3) 


/* which 




MCMD PRESCTR */ 






private 


static 


final 


int 


PCTR VMD 




( 1<<0 ) 


private 


static 


final 


int 


PCTR AMD 




{ 1<<1 ) 


private 


static 


final 


int 


PCTR AVOL 




(1«2) 


private 


static 


final 


int 


PCTR LUM 




(1«3) 


private 


static 


final 


int 


PCTR SAT 




(1«4) 


private 


static 


final 


int 


PCTR GAM 




(1«5) 


/* videc 


mode 




MCMD PRESCTR 







* Oxvvzz 



* w : VDM_C0L, VDM__COLB 

* 22 : zoom [1-3] 
*/ 

43 private static final int VDM_COL 

private static final int VDM_COLB 

/* audio_mode : MCMD_?RESCTR 

50 

* cccqqq 
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*• 


ccc : channel listening selection 


* 


Sxx 


1/0 -> Selection/ No Selection 




101 


Left 




110 


Right 


★ 


111 


Left & Right 


* 


qqq: audio playback quality selection 




Sxx 


1/0 -> Selection/ No Selection 


* 


100 


High 




101 


- Medium 




110 


. Low 


*/ 







/* stream : MCMD_STREAM, MCMD_OPENSRC, MCMD_REENTER 

* vvvvvvvv . ^aaaaaaa 

* aaaaaaaa: 

* a7 : l-> ignore stream identifier part (bits a5-a0) . 

* a6: audio stream subscription 0/ON/ 1/OFF 

* aS: l->auto subscribe to first encountered audio 
scream, 

(a4-a0 = 00000) . 

* a4-a0: subscribe to a particular audio stream [0-31] 

vvvvvvvv : 

v7 : i-> ignore stream identifier pare, bits v5-v0 

v6: video stream subscription 0/ON, 1/OFF 

v5: l->auto subscribe to first encountered video 

stream, 

* (v4-v0 - 00000) . 
v4 ; 0 

* v3-v0: subscribe to particular video stream [0-15] 
*/ 

private static final int STRM_IGNCREID = 0x80; 
private static final int STRM_SBCOFF = 0x40; 

private static final int STRM_AUTOSBC = 0x20; 

static ( 

try System . loadLibrary ( "javampx" ) ; catch 
(Unsat is f iedLinkError e) 

S ys tern . load ( " /opt/SUNWsmc jc/ lib/ 1 ib j avampx . so" ) ; 

} 
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smcrm 

/* 

* @ (#; smcrn. java 
+ 

* Copyright 1995 Sun Microsystems, Inc. All Rights Reserved. 

v version 1 . 0 

* author Christopher Lindblad 
+ 

*/ 

package COM . Sun . isg . smc j c ; 

public class smcrm i{ 

private static byte ( ] parseHandle (String s) { 
int len = s . length () 12 ; 
byte [] h = new byte [len]; 
for (int i = 0; i < len; i + +) { 

h;i] = {byte) Integer .parselnc (s . substring (i*2, 
(i+1) *2) , 16) ; 
t 

return h; 

public static void main (String argsU) throws Exception { 
MsmSession session = null; 
MsmPlayer player; 
if (args. length != 2) { 

System .err . print in ( "usage : smcrm <serverName> 
<piayerHandle>" ) ; 

return ; 

} 

try { 

session = new MsmSession (args [0] ) ; 

player = new MsmPlayer (session, parseHandle (args [ 1 ] ) ) 
player .delete ( ) ; 
i catch (Exception e) { 

System. err .println (" smcrm: " + e) ; 
} finally { 

if (session != null) [ 
try session . close ( ) ; catch (Exception e) 
System. err . println ( "smcrm: " + e) ; 

i 

} 

} 

} 
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smcstat 
/* 

* @ (#) smcstat . java 

* Copyright 1995 Sun Microsystems, Inc. All P.ights Reserved. 

* vers ion 1 . 0 

* author Christopher Lindbiad 



package COM . Sun . isg . smc j c ; 

public class smcsta^t { 

public static void main (String args[]> throws Exception { 
MsrtiSesslon session = null; 
MsnP layer [ ] players ; 
if (args. length ! = 1) { 

System. err .println { "usage: smcstat <serverName>" ) ; 

return; 

} 

try { 

session = new MsmSession (args [ 0 J ) ; 
players = session . players () ; 
System. out. println (session) ; 
for (int i = 0; i < players • length ; i-+) { 
MsmPlayer player = players[i]; 

MsmPersistence persistence = player . getPersis tence () ; 
MsmConnect connect = player . getConnect () ; 
MsmPlayStatus status = player . getPlayStatus () ; 
MsmAccessRight [ ] rights = player . getAccess () ; 
MsmPlaylist playlist = player . getPlayiist () ; 
System. out .println (player) ; 
System. out .println (persistence) ; 
System. cut .println (connect) ; 
System. out .println (status) ; 
for (int j = C; j < rights . length; 5*+) { 
System. out . print In ( rights [ j ] ) ; 

} 

System. out .println (playlist ) ; 

for (int j = 0; j < playlist . items . length; j + + ) { 

if (playlist . items [j ] instanceof MsmTi tlel tern) { 
MsmTi tie Item ti = (MsmTi tie I tern* playlist . items [ j ] 
System . out . println ( 

session. getTitleStatus (ti .-itleName) ) ; 
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} 

} 

> 

. } catch {Exception e) { 

System. err. println ( "smcstat : " + e) ; 
} finally { 

if (session != null) { 
try session. close 0 ; catch (Exception e) 
w System. err . println ( "smcstat : " + e) ; 

} 

> 

} 

> 

15 



20 



25 



30 



35 



40 



45 



SO 
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LOOP 
/* 

* @ (#) loop.c 

+ 

* Copyright 1996 Sun Microsystems, Inc. All Rights Reserved, 

* version 1 . 0 

+ author Stephane C AC HAT 

*/ 

# include <stdio . h> 
#include <stdlib.h> 

# include <sys/ types .h> 

# include <sys/ socket . h> 

# include <netinet/in . h> 

# include <arpa/inet . h> 

# include <string . h> 

#include <netdb.h> 

# include <signal . h> 

# include <errno . h> 

#include <fcntl.h> 

# include <assert.h> 

# include <unistd . h> 

#include <sys/t ime . h> 

# include <sys/ resource . h> 

# include <time . h> 

# include < thread . h> 

^include <sys/errno . h> 

# include <sys/st roots . h> 

# include <f cntl . h> 

# include <atm/ atmioctl . h> 

ttifdef TRUE 
#undef TRUE 
#endif 

#ifdef FALSE 
# under FALSE 
#endi f 

^define FALSE 0 
^define TRUE 1 
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ttdefine BUF 1024*8 

+ + + + + + * + * + * + 

* * * Global variables 

/* Parameters */ 

char servername [256] ; 
char * progName ; 
char *opt; 
int port; 
int portO; 

/* Socket */ * 

struct sockaddr_in adds; 
int skt; 

struct sockaddr_in addr; 
struct sockaddr_in addx; 
struct hostent * hp; 
int len; 

/* buffer */ 

char * buffer=NULL; 

/* Multicast */ 

struct ip_mreq mreq; 
char * host; 

/* Thread V 

thread_t Tpump; 
int okdone=0; 
int f lag=l ; 

/* ATM */ 

int safd; 
inn ppa; 

char ctlbuf [0x100] ; 
^define vc port 

*** Received transmit info Multi 
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10 



void * pumpM(void * result) { 

while (flag) { /*main loop*/ 

len=recvfrom(skt,buf fer,BUF, C , NULL, 0) ; 
if (len) { 

sendto (skt, buffer, len, 0, (struct sockaddr *) 
& (addx) , sizeof (addx) ) ; 
} 

} 

flag=l; 

} 

+ + * + * + + * + + + + + + + + + + 

*** Receive&trarvsmit info ATM *** 

void * pumpA(void * result) { 
struct strbuf ctl; 
struct strbuf data; 
int flags; 
fprintf (stderr, n puaipA\n") ; 
ctl.buf = (char *) ctlbuf; 
ctl.maxlen = 0x100; 
ctl. len = 0; 

data.buf = (char *) buffer; 
data . maxlen = 3U7; 
data. len = 0; 
flags = 0; 

while (flag) { /*main loop*/ 

if (getrusg (safd, &ctl, &data, sflags) < 0) { 

fprintf (stderr , "getmsg failed, errno=%d\n" , errno); 
35 perror ( " " ) ; 

return; 

) 

len=data . len; 
fprin-f (stderr, "len=%d\n M , len) ; 
if (len) { 

sendto (skt,buf fer + <, len-4, 0, (struct soc-iaddr * ). 
& (addx) , sizeof (addx) ) ; 
} 



15 



20 



25 



30 



40 



45 



50 



f lag-1 ; 

} 



Col lec ting arguments 



+ + + 
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void print_usage_and_exit (char* a) { 
if (strlen(a)) f print f ( stderr , a) ; 

fprintf (stderr, "\n%s redirect multicast or atm data stream 
to Io0\n" , progName ) ; 

fprintf (stderr, "UsageW ) ; 

fprintf (stderr , "%s m <Multicast address> <in port> <out 
port>\n" , progName) ; 

fprintf (stderr, M %s a <VC> <out port>\n M , progName) ; 
(void) exit (0) ; 

} 

static void collectArgs (int argcchar **argv) { 
int i; * 
int j=0; 
FILE * f; 

progName=*argv++ ; 

if ( !*argv) pr int_usage_and_exi t ( " " ) ; 

opt=*argv++; 

if (*opt== 1 a ' ) { 

if (!*argv) print_usage_and_exi t ( " " ) ; 

port=atoi (*argv++) ; 

if ( ! *argv) print__usage_and_exi t ("") ; 
portO^atoi (*argv+ + ) ; 

if (port<=0) print_usage_and_exit ( " " ) ; 
if (*argv) print_usage_and_exi t ( " " ) ; 
f=fopen(" ./loop.conf "r") ; 
if ( 1 f ) { 

fprintf (stderr, "Can 1 t open loop.conf"); 
exit (-1) ; 

} 

ho5t= (char*) malloc(256); 
fscanf (f , "%s", host) ; 
fclose(f); 
}else if (*cpt=='nT ) { 

if (!*argv) print_usage_and_exi t ( " " ) ; 
host=*argv++ ; 

if ( ! *argv) print_usage_and_exit ( " " ) ; 
port=atoi (*argv^+) ; 

if ( ! *argv) print_usage_and_exit ( " " ) ; 
port0=atoi (*argv++) ; 

if (port<=0) print_usage_and_exit ( 11 " ) ; 
if (*argv) print_usage_and_exic ( " " ) ; 
} else print_usage_and_exit ( M ,f ) ; 

} 
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* ** Getting server IP adress * 

void getaddr ( ) ( 
int udpport; 
unsigned long inaddr ; 
struct ho stent * hp; 
char n [256] ; 
int i; 

if (gethostname (servername, 256) ==-1 ) 
print_usage_and_exit ( "error while getting hostname 
if ( { inaddr=inet_addr (servername) ) ! =-1 ) { 

adds . sin_addr . ^addr=inaddr ; 
}else { 

hp=gethostbyname (servername) ; 
if (hp!=NULL) { 

adds . sin_addr . s_addr- ( (struct in_addr* ) 
hp->h_addr) ->s_addr; 

adds . sin_port = htons (udpport ) ; 

} 

> 

if ( ( inaddr=inet_addr (host) ) !=-l) { / * hostname * / 

mreq . imr_mul tiaddr . s_addr=inaddr ; 
}else[ 

hp=gethos tbyname (host) ; 
if (hp!=NULL) { 

mreq . imr_mul t iaddr . s_addr= ( (struct in__addr* ) 
hp->h_addr) ->s_addr; 
}else{ 

f print f ( seder r , "Multicast connect f ailed\n M ) 

) 

} 

/* mreq. imr_inter f ace . s_addr=INADDR_ANY; */ 
gethostname (n, 256) ; 
hp-gethos tbyname (n) ; 
if (hp!=NULL) { 

mreq . imr_inter f ace . s_addr= ( (struct in_addr* ) 
hp->h_addr) ->s_addr; 

addx . sin_addr . s_addr= ( (struct in_addr * ) 
hp->h_addr) ->s_addr; 

addx . sin__port = htons (port 0 ) ; 
)else{ 

fprintf (stderr, "Multicast connect faiied\n" ) 
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*** Socket setting Multicast *** 
* + + + + + + * + / 

void goM( ) { 
getaddr ( ) ; 

skt=socket (AF_INET, SOCK_DGRAM, 0) ; 
if (skt==0) { 

perror ( "Create socket" ) ; 

exit (EXIT_FAI LURE) ; 

> 

addr . sin_f amily = AF_INET; 

addr . sin_addr . s_addr = INADDR_ANY; 

addr . sin_port = htons(port); 

bind ( s kt, (void * ) &addr, sizeof (addr) ) ; 

iff setsockopt (s^t, IPPR0?0_IP, IP_ADD_MEMSERSHI P, (char * ) &mreq, 
sizeof (struct ip__mreq) ) == -1 ){ 

fprintf ( stderr , "Can 1 1 join multicast membership"); 
exit (0) ; 

} 

if (fcntl (skt, F_SETFL, 0__NDELAY ) ==-1 ) ( 

f print f ( stderr , "set socket options nb"); 
exit (EXIT_FAILURE) ; 

} 

if (thr_create (0,0, pumpM, 0,0, &Tpump) / perror ( "Can * t create 
Dispatcher" ] ; 
} 

ATM interface setting 

void goA ( J i 
ir.t udpport; 
unsigned long inaddr; 
struct hostent + hp; 
char u I 256 ] ; 

char interface ( 10 ] ; 

menset ( interface, 0, sizeof (interface)); 
strcpy { inter face, host) ; 

ppa = interface [strlen (interface) - 1] - '0 1 ; 
if ((safd = sa_open (interface) ) < 0) { 

fprintf (stderr, "open failed, errno=%d\n" , errno) ; 

perror t "open" ) ; 

exit (-1) ; 

> 

fprintf (stderr, " ready to attach\n n ); 
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sa_attach (saf d, ppa, -1); 
fprintf (stderr, "attached\n" ) ; 

if (sa_add_vpci (safd, vc, NULL_ENCAP, BIG_BUFJTYPE) < 0) 

fprintf (stderr, "sa_add_vpci failed, errno=%d\n", errno) 

exit (-1) ; 

} 

sa_setraw (saf d) ; 

gethostname (n, 256) ; 
hp=gethostbyname (n) ; 
if (hp!=NULL) { 

addx . sin_addr . s_addr= { (struct in_addr * ) 
hp->h_addr) ->s_addr; 

addx . sin_port = htons (portO ) ; 
}else{ 4 

fprintf (stderr, "loO connect failed\n"); 

} 

skt=socket (AF_INET, SOCKJDGRAM, 0) ; 
if (skt==0) { 

perror ( "Create socket"); 

exit ( EX I T_FAI LURE ) ; 

} 

addr . sin__f ami ly = AF_INET; 

addr . s in_addr . s_addr = INADDR_ANY ; 

addr . sin_port = htons (port 0) ; 

bind (skt, (void * ) &addr , sizeof (addr) ) ; 

if ( f cntl (skt, F_SETFL, 0__NDELAY) ==-1 ) { 

fprintf ( stderr, "set socket options nb" ); 

exit (EXIT FAILURE) ; 



if ( thr_create (0,0, pumpA, 0,0, &Tpump) ) perror ( "Can 1 t creat 
Dispatcher" ) ; 
} 

+ + + * + + + + + + + + + + + * + + + * 

*** Cleaning ATM *** 
* + + + + *** + ** + ***** + + *■★*'* + *** + + + + ** + + ** + ** + * + * + * + **/ 



void doneA(int arg) { 
fprintf (stderr, "loop killed by signal %d\n", arg) ; 
if ( !okdone) {okdone-1; 
f lag-0; 

while ( ! flag) { 
sleep ( I ) ; 

} 

fprintf (stderr, "dispatcher :<illed\n" ) ; 
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if (sa_delete_vpci (safd, vc) < 0) { 

fprintf (stderr, "sa_delete_vpci failed, errno=%d\n", errno) , 

}; 

fprintf (stderr, "ready to detach\n M ); 

sa_detach (safd, -1) ; 
fprintf (stderr, " detached\n" ) ; 

sa_close (safd) ; 

close (skt ) ; 

printf ("socket closedW); 
if (buffer) f ree (buf f er ) ; 
printf ("Buffer free\n"); 
exit (0) ; 

> 1 

★ + +**+***+****+++#*********+++**+* 

*** Cleaning Multicast *** 
***★★* + + + + * + + ****** + + + + + + + **** + ********'*'' r **'*''*■*****/ 

void doneM(int arg) { 
if ( !okdone) {okdone=l; 
if (setsockopt (skt, IPPROTO^IP, IP_DROP_MEMBERSHIP, (char *) 
&mreq, sizeof (mreq) ) ==-1 ) { 

fprintf (stderr, "Can 1 t drop multicast membership" ) ; 

exit (0) ; 

} 

printf ("Multicast membership droppedW ) ; 
f lag=0; 

while (Iflag) { 
sleep ( 1 ) ; 

} 

printf ( "dispatcher kiliedW) ; 
close (skt) ; 

printf ( "socket closedW ) ; 
if (buffer) free (buf fer) ; 
printf ("Buffer f ree\n") ; 
exit (0) ; 

} f 

/ + * + + + + + + + + + + * + + * + * + + + + + + + + 

+** Main 

int main(int argc, char** argv) 
{ 

int i; 
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buf f er= (char* ) mailoc (BUF) ; 
collectArgs (argc, argv) ; 
if <*opt=='m' ) { 

printf ("host=%s, port=%d / portO=%d\n" , host, port , portO) ; 

signal (SIGQUIT, doneM) ; 

signal (SIGINT, doneM) ; 

signal (SIGUSR1 , doneM) ; 

signal (SIGUSR2 , doneM) ; 

printf ("go M\n") ; 
goM ( ) ; 
lelse if (*opt« , a f ) { 

printf ("inter facets, vc=%d, port 0 = %d\n" , host , vc, portO ) ; 
signal (SIGQUIT, doneA) ; 
signal (SIGINT, dpneA) ; 
signal (SIGUSR1 , doneA) ; 
signal (SIGUSR2, doneA) ; 

printf ("go A\n"> ; 
goA ( ) ; 

} 

printf ("loop\n") ; 
while (1) sleep (60) ; 

} 



Claims 

1. A method for processing in a computer which includes a memory a bit stream received from a bit stream server 
which is operativeiy coupled to the computer through a network, the method comprising 

retrieving from a multimedia document stored in the memory a specification of a title: 

building from the specification of the title bit stream control signals which request a bit stream representing 
the title and which are in a form appropriate for processing by the bit stream server: 

transmitting the bit stream control signals to the bit stream server to thereby request from the bit stream server 
a bit stream representing the title: 

building from the specification of the title decoder control signals which direct a decoder to receive the bit 
stream from the bit stream server and which are in a form appropriate for processing by the decoder- and 
transmitting the decoder control signals to the decoder to thereby cause the decoder to receive and decode 
the bit stream. 

2. An applet, capable of executing within a computer system, for requesting and controlling decoding of a bit stream 
specified in a multimedia document stored in a memory of the computer system the applet comprising: 

an API module (i) which is configured to build from a specification of the bit stream in the multimedia document 
bit stream control signals which request transmission of the bit stream from a bit stream server and which are 
in a form appropriate for processing by the bit stream server and (ii) which is configured to transmit the bit 
stream control signals to the bit stream server to thereby request from the bit stream server a bit stream 
representing the title: and 

a decoder module (i) which is operativeiy coupled to the API module: (ii) which is configured to butld from the 
specification of the bit stream in the multimedia document decoder control signals which direct a decoder to 
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receive the bit stream from the bit stream server and which are in a form appropriate for processing by the 
decoder; and (iii) whtch ts configured to transmit the decoder control signals to the decoder to thereby cause 
the decoder to receive and decode the bit stream 
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(54) Video on demand applet method and apparatus for inclusion of motion video in multimedia 
documents 



(57) The present specification describes a computer 
process which requests streams of motion video titles 
and decodes and displays the motion video signals of 
the stream for display in a computer display device is 
constructed in the form of an applet 2i 2 of a multimedia 
document viewer 202 such as a World Wide Web brows- 
er. Accordingly, a designer of multimedia documents 
such as HTML pages can easily incorporate motion vid- 
eo titles into such HTML pages by specifying a few pa- 
rameters of a desired title or a desired portion of a title 
to be requested from a video server 250. The applet 21 2 
builds bit stream control signals from the specification 
of the title or the portion of the title. The bit stream control 
signals request transmission of the title or the portion of 
the title from a bit stream server such as a video server 
250 and are in a form appropriate for processing by the 
bit stream server. The applet 212 transmits the bit 
stream control signals to the bit stream server 250 to 
thereby request that the bit stream server 250 initiate 
transmission of a bit stream representing the requested 
title or the requested portion of the title. The applet 212 
also builds decoder control signals from the specifica- 
tion of the title or the portion of the title. The decoder 
control signals direct a bit stream decoder 204 to receive 
the requested bit stream from the bit stream server 250 
and to decode a motion video signal from the bit stream. 
The applet 212 transmits the decoder control signals to 
the decoder 204 to cause the decoder 204 to receive 
the bit stream and to decode the motion video signal 
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